4 ms·
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 sta
by bschwindHN 8y ago
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 https://doc.rust-lang.org/beta/rustdoc/what-is-rustdoc.html
- mpolsz 8y agoAs 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.
- steveklabnik 8y agoLocalization is basically non-existent :( it’s a thing we want to work on, but aren’t sure how to accomplish.
- Manishearth 8y agoI've discussed this a fair bit and we have a rough plan, but the idea is to wait for other things to localize first.
- steveklabnik 8y agoAh great!