Skip to content

docs: Docs button looks already pressed on homepage #183

Description

@rakyll

Docs button on the homepage is highlighted in a way that it looks already pressed and I'm reading "Docs". I looked around for a while to find a link to JSDocs, knowing that they are somewhere. A user will likely to close the page assuming there is nothing besides the homepage.

Activity

  1. ryanseys commented on Sep 5, 2014

    @ryanseys
    Contributor

    +2 I thought this as well.

  2. stephenplusplus commented on Sep 6, 2014

    @stephenplusplus
    Contributor

    What would help? Flipping the hover color from dark to light (current) to light to dark?

  3. ryanseys commented on Sep 6, 2014

    @ryanseys
    Contributor

    Easiest thing I can see is making the Docs button look like all the other
    buttons. Or more complicated way is move it away from all the other buttons
    eg up near the installation command.

  4. stephenplusplus commented on Sep 6, 2014

    @stephenplusplus
    Contributor

    @leomaia any ideas? :)

  5. leomaia commented on Sep 6, 2014

    @leomaia

    I totally understand what you guys are saying.

    I designed this page to be prepared to house multiple docs pages from different programming languages. The main access to the page would be through a dropdown button next to the Google Cloud Platform logo which I would not remove it even with just one language. That would give a hint to users that more content will be added in the future.

    The red button would be a second and redundant point of access and that would be inserted in a carousel where you would be able to see multiple sets of "red button + external links", one for each language and instead of just simply "Docs" as a label for the button you would have "Node.js Docs", "Python Docs" and so on. Also, I wanted to make the button much more prominent than the other links.

    One simple fix would be to make the button's hover state more perceivable, maybe adding a darker border or a drop shadow.

    Another solution would be to provisionally change things a little bit in this area, dropping the red button and changing the title with a link to the "Docs" page.

    I attached some examples.

    001-original-design
    002-hover-state
    003-alternative

  6. stephenplusplus commented on Sep 7, 2014

    @stephenplusplus
    Contributor

    Thanks for the background info. I think I prefer the text example, "Check out the Docs," or some variant of that phrasing, maybe even just "API Documentation".

  7. leomaia commented on Sep 7, 2014

    @leomaia

    Cool! Even better.

  8. silvolu commented on Sep 8, 2014

    @silvolu
    Contributor

    Thanks @leomaia!
    I don't think that keeping the language selector would make much of a difference: the problem here is that the prominency of the Docs button makes me think that it's the selected option, and all we have for docs is the landing page that I'm seeing ( I would not think of clicking it to go the API reference).
    We need a more clear call to action (e.g. "Check out the Docs" as proposed by @stephenplusplus or "Go to the API reference"), or the button to appear as the other in the nav bar (so that I understand that I'll go somewhere else when I click it).

  9. leomaia commented on Sep 8, 2014

    @leomaia

    Sure! No problem.

  10. ryanseys commented on Sep 18, 2014

    @ryanseys
    Contributor

    Fixed?

  11. added this to the Core Stable milestone on Feb 2, 2015
  12. 55 remaining items

  13. added a commit that references this issue on Mar 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

🚨This issue needs some love.triage meI really want to be triaged.

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions