Code Monkey home page Code Monkey logo

Comments (9)

seeekr avatar seeekr commented on August 21, 2024 2

OK, a couple bits of feedback about that:

  1. The visual you're using is not really a common one, so for most users they won't recognize that as a GH page link even if they see that thing in front of their eyes. The idea is nice to give an overview of important GH stats, but that will not help spot the link very well.

  2. The visual is only visible on the "crate" tab. The default tab is "documentation", and users really shouldn't have to navigate to the "crate" tab in order to be able to go to the crate's (GH) repository.

So basically I'd suggest putting an additional link in a well-known, common, most recognizable format on either the docs tab or on all tabs. I just did a quick look at how people are linking their GH repos, and the most common is of course the "fork me on GH" banner in the top right. That might be somewhat intrusive but would the user serve better than a hidden link. Alternatively lots of sites use (or used to use?) the GH star button thingy to link to their GH repo, which is less intrusive and could also be placed right next to the crate name at the top of the docs.rs page.

HTH!

from docs.rs.

jyn514 avatar jyn514 commented on August 21, 2024 2

Reopening as it looks like this is more about the design of the links then whether they exist or not.

from docs.rs.

Nemo157 avatar Nemo157 commented on August 21, 2024 2

One thing that could help with that is inserting spacers for grouping. There is a lot of available whitespace on a desktop view there.

from docs.rs.

bestia-dev avatar bestia-dev commented on August 21, 2024 1

You can Close this issue.
Now the Links for the Repository are very intuitive:
image

Thanks.

from docs.rs.

onur avatar onur commented on August 21, 2024

There is a GitHub link in crate pages. regex crate for example:

githublink

You are not the only one missing this link. I don't know how can I make it more clear.

from docs.rs.

Kixiron avatar Kixiron commented on August 21, 2024

Closing as the links do exist

from docs.rs.

bestia-dev avatar bestia-dev commented on August 21, 2024

It is indeed hard to find. I didn't find it. This is the reason I came here searching for a solution.
Now I know, but it is absolutely not intuitive.
First find the "menu bar" that is hardly visible. It looks like "disabled items".

Then open the name+version of the crate. Then find links.

It would be much easier to have something familiar like crates.io:

Thank you for docs.rs, it is fantastic to have documentation all in one place. Great !

from docs.rs.

jyn514 avatar jyn514 commented on August 21, 2024

@LucianoBestia my concern for your suggestion is that it takes up more of the top-level real estate in the header bar. The more links we put there, the harder it is to find any individual link. Notice how your mockup has 6 links, compared to the 3 in crates.io and 4 on docs.rs currently.

from docs.rs.

jyn514 avatar jyn514 commented on August 21, 2024

The visual you're using is not really a common one, so for most users they won't recognize that as a GH page link even if they see that thing in front of their eyes. The idea is nice to give an overview of important GH stats, but that will not help spot the link very well.

This was fixed in #1242.

from docs.rs.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.