Docs.rs: Feature request: list crate features at the top of package index.html

[kespindler]

When learning Rust, it's surprising to not find a namespace available within a package. Having crate features available at the top of the docs.rs package would be a great indication that some namespaces are gated behind features.

[jyn514]

I think listing all the features of the crate is useful and in scope (maybe under the crate tab). However, we can't put it on the page for every module since those pages are generated by rustdoc.

[jyn514]

Or in other words: just finding which features are available is simple, we just parse Cargo.toml; finding what changes when a given feature is enabled/disabled requires expanding macros and parsing the code and also lies on a weird boundary between cargo and rustdoc.

[jyn514]

There's an extension that adds this already and I like their approach - they put an extra Features drop-down in the header at the top.

https://rust-search-extension.now.sh/feature-flags.png

[jyn514]

Relevant code:

• header template
• adding releases to the database
• Cargo.toml parsing - note that this is CargoMetadata, not Metadata. Metadata is only used for controlling the build parameters.

[Nemo157]

One change I would suggest for the example drop-down would be to highlight the default feature, maybe by moving it to the top and adding a little whitespace/horizontal rule between it and the rest.

[jyn514]

This was added in https://github.com/rust-lang/docs.rs/pull/1144.