Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding one more tab for crate's features #2405

Closed
HosMercury opened this issue Jan 31, 2024 · 4 comments
Closed

Adding one more tab for crate's features #2405

HosMercury opened this issue Jan 31, 2024 · 4 comments

Comments

@HosMercury
Copy link

HosMercury commented Jan 31, 2024

I suggest adding one more tab for each crate to doc their features

after versions tab or beside !!

Right now there is no good way to find every crate feature and their usage. Organizing features will facilitate the finding and usefulness of a crate feature and how to use it.

@syphar
Copy link
Member

syphar commented Feb 1, 2024

Hi @HosMercury

can you elaborate what's missing for you?

We already have a menu template for features:
image

And some generated description around them:

https://docs.rs/crate/itertools/latest/features

@HosMercury
Copy link
Author

First time to know that
Although each feature should be better documented. Right?

@syphar
Copy link
Member

syphar commented Feb 1, 2024

Although each feature should be better documented. Right?

Yeah, that's true, which is why we added this comment:

There is very little structured metadata to build this page from currently. You should check the main library docs, readme, or Cargo.toml in case the author documented the features in them.

@Nemo157
Copy link
Member

Nemo157 commented Feb 21, 2024

Also see rust-lang/rfcs#3485 which we could eventually pull the data from (or deprecate our feature-flags page once rustdoc starts generating data based off it).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants