Skip to content

Translations are somewhat inaccessible #3429

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

Open
ChaiTRex opened this issue Nov 18, 2022 · 2 comments
Open

Translations are somewhat inaccessible #3429

ChaiTRex opened this issue Nov 18, 2022 · 2 comments

Comments

@ChaiTRex
Copy link

URL to the section(s) of the book with this problem:

https://doc.rust-lang.org/stable/book/appendix-06-translation.html

Description of the problem:

The links to translations of the book go to GitHub repositories rather than to those translations as collections of already-built web pages.

This means that, while English speakers get a nice, convenient introduction to Rust in their web browser, those who speak other languages have to somehow figure out how to build the book.

The problem is that this requires Cargo to be installed, and there's no reason why a newcomer would know how to install that, as that's taught in the book and they can't access it in their language yet.

@chriskrycho
Copy link
Contributor

Mmm, yeah, this is a real challenge. Right now, something like this is probably beyond our ability to wrangle, because all of the translations are unofficial and don’t have any kind of review or choose between alternatives (though I expect they are broadly very good!), and there is not currently any infrastructure in place for publishing multiple language versions of the book. I am not closing this though, because I think getting internationalization infrastructure for the book would be awesome. It is just not currently at (or close to) the top of the priority list!

@dalance
Copy link

dalance commented Feb 3, 2025

#464 (comment) is a proposal for an infrastructure in place for publishing multiple language versions of the book.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants