crates.io documentation generator
OTOH, source-code-generated-docs normalize how code docs are, like the rust docs.rs paradigm, so it sort of forces or encourages package creators/maintainers to write docs.
The Rust Programming Language
doc.rust-lang.org/book: More of a "guides" thing than a source-code doc thing.
Learn any GitHub repo in 59 seconds. Onboard AI learns any GitHub repo in minutes and lets you chat with it to locate functionality, understand different parts, and generate new code. Use it for free at www.getonboard.dev.
Lua is a powerful, efficient, lightweight, embeddable scripting language. It supports procedural programming, object-oriented programming, functional programming, data-driven programming, and data description.
I think Lua is a good example of doing documentation well. The source code is commented only as much as needed, mainly with brief comments about things that might not be obvious and a small number of longer explanations of how the architecture works (mainly relevant to developers). It also has a super nice feature that's surprisingly rare: each file has a very short line at the top that describes what the file is, so you don't have to guess based on the filename alone. The API is documented in a single HTML file on the website that has both the high level descriptions of the language and architecture, as well as documentation for each public-facing function. The docs are maintained by hand, but the API is mostly stable, so the docs don't need to change very often.
Systems programming - Rust
1 project | /r/learnrust | 6 Nov 2023
Ask HN: How do you learn Rust in 2023?
1 project | news.ycombinator.com | 3 Nov 2023
Give me the best Resources to learn Rust
2 projects | /r/rust | 1 Nov 2023
What are the best tools to learn Rust in the most comprehensive and complete way? (courses, books etc)
1 project | /r/rust | 21 Oct 2023
Ask HN: Best tools for self-authoring books in 2023?
3 projects | news.ycombinator.com | 10 Oct 2023