Skip to content

Differentiate the documentation pages for new users. #2135

Open

Description

Hi, this is not a high priority issue but it's one I just want to have here.

When I was learning Rust for the first time, the documentation pages confused me, especially since the entry point for a lot of users is just googling "rust" + "some stuff" and see if documentation exists.

So Googling "rust rand" gives me this page https://docs.rs/rand/latest/rand/ which has the same look and feel as the official rust documentation page. https://doc.rust-lang.org/std/

Except for a slightly different logo and the top bar.

But for a new user that is going between pages, to them this is the same page. And then they need to learn that, no, rand is actually a library.

So, to help out new users. Can docs.rs or the official docs page do something visual to differentiate them from each other.

Color, layout, highlights, something obvious when you enter the page and scan around.

Something that tells you immediately "We're not in Kansas anymore."

<3

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Assignees

No one assigned

    Labels

    A-frontendArea: Web frontendA-newcomer-roadblockArea: A problem that isn't a bug, but makes it harder for people to contribute

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions