1. 1. What is rustdoc?
  2. 2. How to read rustdoc output
  3. 3. How to write documentation
  4. 4. What to include (and exclude)
  5. 5. Command-line arguments
  6. 6. The #[doc] attribute
  7. 7. Documentation tests
  8. 8. Linking to items by name
  9. 9. Lints
  10. 10. Advanced features
  11. 11. Unstable features
  12. 12. Website features
  13. 13. Passes
  14. 14. References

The Rustdoc book

References

There are many great rustdoc references out there. If you know of other great resources, please submit a pull request!

Official

  • Learn Rust
  • Rust By Example
  • Rust Reference
  • RFC 1574: More API Documentation Conventions
  • RFC 1946: Intra Rustdoc Links

Community

  • API Guidelines
  • Github tagged RFCs
  • Github tagged issues
  • RFC (stalled) front page styleguide
  • Guide on how to write documentation for a Rust crate