News for hackers. Stuff that matters.
Re:How I Judge the Quality of Documentation in 30 Seconds (2... by bschwindHN on Saturday October 06, 2018 @01:40AM (#18153717)
I'm very thankful for Rustdoc. Every library's documentation has the same, easily searchable format. The syntax for writing documentation is easy to use and standard across all Rust projects. You can easily generate HTML documentation from your source code and standalone markdown files. crates.io will generate your documentation and host it for you when you publish a library. Your example code in your documentation can actually be compiled and tested so it stays up to date. It's been a joy to use and a major reason I like programming in Rust.

I don't know about localization support, but it addresses most of the other issues outlined in the article.

https://doc.rust-lang.org/beta/rustdoc/what-is-rustdoc.html

Re:How I Judge the Quality of Documentation in 30 Seconds (2... by mpolsz on Saturday October 06, 2018 @03:29AM (#18154003)
As hard as rust is in itself, it tries to lower most of the other barriers to entry for new programmers. I think that central package repository coupled with sane package manager and consistent documentation is must have for any new language on the market. Both Rust and Elixir have official package manager and repository with documentation hosting and it makes life much easier. This and not having to worry about another holly war later on.
Re:How I Judge the Quality of Documentation in 30 Seconds (2... by steveklabnik on Saturday October 06, 2018 @10:20AM (#18155239)
Localization is basically non-existent :( it’s a thing we want to work on, but aren’t sure how to accomplish.
Re:How I Judge the Quality of Documentation in 30 Seconds (2... by Manishearth on Saturday October 06, 2018 @12:53PM (#18156009)
I've discussed this a fair bit and we have a rough plan, but the idea is to wait for other things to localize first.
Re:How I Judge the Quality of Documentation in 30 Seconds (2... by steveklabnik on Saturday October 06, 2018 @02:16PM (#18156443)
Ah great!