Skip to content

Rustdoc should show both a stability colour, and unstable/deprecation text #24617

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

Closed
thepowersgang opened this issue Apr 20, 2015 · 7 comments
Closed
Labels
T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue.

Comments

@thepowersgang
Copy link
Contributor

While the recent change to make deprecated items more obvious is nice, the lack of colour annotations makes it harder to scan down a list (e.g. in trait impls) and spot stable/unstable items.

Could the colours be restored (along side the new warning boxes)?

@steveklabnik
Copy link
Member

One of the reasons the colors were bad was color-blind users...

@steveklabnik steveklabnik added the T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue. label Apr 20, 2015
@steveklabnik
Copy link
Member

/cc @alexcrichton

@thepowersgang
Copy link
Contributor Author

Understandable. As said, I just think the colours (and maybe symbols?) should return along side the new text boxes. For easier scanning (and inclusion alongside the prototypes)

@alexcrichton
Copy link
Member

The idea here is that the set of unstable/deprecated items is actually pretty small, so there doesn't need to be that much visual distinction, but I'd certainly believe that the UI could be better.

@steveklabnik
Copy link
Member

We no longer have colors, and we do display a message for unstable/deprecated things. Closing!

@steveklabnik
Copy link
Member

Well, I guess this ticket was about adding them back in, so let's leave this open just in case. @thepowersgang with all of the changes here, do you still think we could do better?

@steveklabnik steveklabnik reopened this Jun 27, 2016
@steveklabnik
Copy link
Member

Okay, it's been a while; I'm going to give this one a close. If someone feels strongly about it and has a proposal for today's situation with regards to stability markers, please open a new issue. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
T-rustdoc Relevant to the rustdoc team, which will review and decide on the PR/issue.
Projects
None yet
Development

No branches or pull requests

3 participants