Nightly feature preview in the docs search menu

This is the search menu on the Rust's documentation website. A column here to indicate if whether the feature is nightly without having to open it would be convenient & time saving. We could also use a different shade for the rows that are nightly features.

2 Likes

There's a lot of information missing in the search results that might be useful. However, it's important to keep the search results uncluttered, so that the focus is on the most important information.

I think unstable items would be a good idea to highlight though, perhaps with a red asterisk.

Another important piece of information that's currently missing is the kind of item. It can be deduced from the color, but that is hard to remember, even when you use the search regularly. Furthermore, conveying information only in colors makes the page inaccessible for color blind and visually impaired people.

This is particularly annoying when multiple items with the same name exist:

There's a macro and a struct with the same name. To get to the correct page, you need to remember which color indicates which item kind. Reading the description might give you this information, but not always. A legend at the top would be really useful:

That's still not great for accessibility, though. Ideally, the item kinds could be clicked to only show traits, or only structs, etc.

1 Like

Unstable items need the opposite of highlighting when Iā€™m writing for stable (which should be the default assumption). They need graying-out, or obviously the best would be to hide them altogether from stable docs. At the very least there should be a toggle to hide them. They are 100% unnecessary and distracting, and warning symbols and highlights simply make them even more distracting.

6 Likes

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.