book icon indicating copy to clipboard operation
book copied to clipboard

Translations are somewhat inaccessible

Open ChaiTRex opened this issue 3 years ago • 2 comments
trafficstars

  • I have searched open and closed issues and pull requests for duplicates, using these search terms:
    • is:issue translation
  • I have checked the latest main branch to see if this has already been fixed, in this file:
    • https://github.com/rust-lang/book/blob/main/src/appendix-06-translation.md

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.

ChaiTRex avatar Nov 18 '22 01:11 ChaiTRex

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!

chriskrycho avatar Apr 24 '24 18:04 chriskrycho