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

The book dead links have gotten so bad that the real book isn't even in search results #1800

Closed
kornelski opened this Issue Feb 5, 2019 · 4 comments

Comments

Projects
None yet
2 participants
@kornelski
Copy link
Contributor

kornelski commented Feb 5, 2019

At the moment if you search for "rust raw pointers" on Google (DDG is even worse), you get:

  1. https://doc.rust-lang.org/book/first-edition/raw-pointers.html which is an outdated stub.

  2. https://doc.rust-lang.org/book/raw-pointers.html which is another outdated stub.

  3. https://doc.rust-lang.org/1.30.0/book/first-edition/raw-pointers.html which has some content, but it's clearly marked as outdated.

  4. https://doc.rust-lang.org/std/primitive.pointer.html — finally some content that isn't outdated, but it isn't the book.

and then follows a bunch of links to StackOverflow, Reddit, and blogs. I can't find the actual, up-to-date contentful version of the book on several result pages. It looks like the stubs have completely pushed it out of the search results!

Search results for this and many other Rust-related queries are irritating garbage. Please, please, please, block the useless pages from crawlers.

@steveklabnik

This comment has been minimized.

Copy link
Member

steveklabnik commented Feb 5, 2019

This is a duplicate of many, many issues, so I’m going to close it. Thanks.

@kornelski

This comment has been minimized.

Copy link
Contributor Author

kornelski commented Feb 5, 2019

Is there any action taken on this? What can I do to help fix it?

@steveklabnik

This comment has been minimized.

Copy link
Member

steveklabnik commented Feb 5, 2019

Two examples of open issues tracking this are rust-lang/rust#18558 and rust-lang/rust#9461 as well as rust-lang/rust#44687 in some sense

What can I do to help fix it?

We need a plan of action first. Some of the constraints on this plan:

  1. it has to work well with docs offline as well as online
  2. offline docs cannot use a local web server
  3. the contents of older doc versions cannot be modified

changing these constraints is possible, but requires an RFC. If you have any ideas, maybe work on the start of a plan and open an internals thread, and we can discuss there? I do care about this issue, it's just complex and the number of helping hands is small. Some help would be great :)

@kornelski

This comment has been minimized.

Copy link
Contributor Author

kornelski commented Feb 6, 2019

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.