Comments (9)
OK, a couple bits of feedback about that:
-
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.
-
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.
Reopening as it looks like this is more about the design of the links then whether they exist or not.
from docs.rs.
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.
You can Close this issue.
Now the Links for the Repository are very intuitive:
Thanks.
from docs.rs.
There is a GitHub link in crate pages. regex
crate for example:
You are not the only one missing this link. I don't know how can I make it more clear.
from docs.rs.
Closing as the links do exist
from docs.rs.
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.
@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.
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)
- Add support to display documentation for one crate as one single page to docs.rs HOT 6
- [Build Failure]: index.crates.io not reachable HOT 16
- Tracking Issue for Packages as (optional) namespaces HOT 1
- Bevy Engine docs aren't detailed HOT 1
- [Build Failure] cedar-local-agent 2.0.0 HOT 3
- big_space 0.5.0 Build Failed HOT 1
- [Default Theme Issue]: Ayu HOT 5
- [Android Doc Builds]: Fails to missing compiler HOT 6
- Add links that point to crates.io HOT 2
- RUSTSEC-2024-0320: yaml-rust is unmaintained. HOT 1
- Add eslint check HOT 2
- Compile error occurs when the build target is x86_64-apple-darwin and using cross-compile dependency HOT 2
- show crates.io search errors to the user without logging them HOT 1
- show "source file too big" when fetching source files that are bigger than our limit HOT 5
- Docs.rs does not compile on nightly since nightly-2024-04-05 HOT 6
- A crate that exists on crates.io does not exist on docs.rs HOT 9
- RUSTSEC-2024-0335: gix-transport indirect code execution via malicious username HOT 3
- docs.rs source view adds Cargo.lock files that are not the crate HOT 3
- Can't build crates that need to download C/C++ dependencies from github HOT 1
- error: failed to run custom build command for `ring v0.17.8` HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
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.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docs.rs.