Skip to content
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

Many links in google for old docs #56700

Closed
ahupp opened this issue Dec 11, 2018 · 7 comments
Closed

Many links in google for old docs #56700

ahupp opened this issue Dec 11, 2018 · 7 comments
Labels
A-docs Area: documentation for any part of the project, including the compiler, standard library, and tools P-low Low priority T-infra Relevant to the infrastructure team, which will review and decide on the PR/issue.

Comments

@ahupp
Copy link

ahupp commented Dec 11, 2018

Many rust-related search terms in google return documentation that's out-of-date. The docs do make clear that they are old, but don't link to the newest version. Some examples:

"rust rc" returns this as the 3rd link:

https://doc.rust-lang.org/book/second-edition/ch15-04-rc.html

"rust types of closure" returns this as the first link:

https://doc.rust-lang.org/book/first-edition/closures.html

IMO, the best option is to remove these from the index entirely; if anyone really wants docs for old versions of the language they can probably find them manually.

To do this, I believe you can either put:

<meta name="robots" content="noindex" /> 

per https://support.google.com/webmasters/answer/93710?hl=en, or hide them with robots.txt.

@estebank estebank added the A-docs Area: documentation for any part of the project, including the compiler, standard library, and tools label Dec 11, 2018
@steveklabnik
Copy link
Member

steveklabnik commented Dec 11, 2018 via email

@spacejam
Copy link

I hit this a few times per week, and just did an issue search to see what the conversation was like around this.

This has been an issue since before 1.0 (especially before 1.0 since things changed far more drastically and frequently back then) and some work has been done to address it over time:
#12466

At the time, the fixes addressed the biggest blocker issues but fell short of adding canonicalization, which I believe is the main way to address this that has been brought up, but not implemented to my knowledge.

A concrete proposal that hasn't received much attention, but I think may be worth considering:
#9461 (comment)

@steveklabnik steveklabnik added the P-low Low priority label Dec 27, 2018
@kornelski
Copy link
Contributor

Related/dupe: #44894

@ahupp
Copy link
Author

ahupp commented Jan 28, 2019

The bulk of the issues I run into are due to links to https://doc.rust-lang.org/book/second-edition. There's a lot of other issues around canonical urls and such, I think we'd get 50% of the value by just putting "" in each page of second-edition, so that the up-to-date version of the book will be the top link.

It doesn't look like that's something I could fix with a pull request.

@jonas-schievink jonas-schievink added the T-infra Relevant to the infrastructure team, which will review and decide on the PR/issue. label Mar 6, 2020
@kornelski
Copy link
Contributor

kornelski commented Mar 14, 2020

This is still a problem, and it still hurts new users (today's example)

Previously I've excluded pre-1.0 docs only, but 40 releases later, early stable docs are quite obsolete too, so here's another take: #69992

@kornelski
Copy link
Contributor

Still in progress #68677

@Dylan-DPC
Copy link
Member

Closing this as it's a closely related to of #44894 and that issue can track both

@Dylan-DPC Dylan-DPC closed this as not planned Won't fix, can't repro, duplicate, stale Sep 1, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-docs Area: documentation for any part of the project, including the compiler, standard library, and tools P-low Low priority T-infra Relevant to the infrastructure team, which will review and decide on the PR/issue.
Projects
None yet
Development

No branches or pull requests

7 participants