Module show_notes::e001

source ·
Expand description

Document all the things!

  • Date: October 3, 2015
  • Subject: Documentation in general, and rustdoc and cargo doc in particular.
  • Audio


This is a mostly-empty module, and it is intended as such. Why? Well, because almost all the sample code exists in these comments, which serve as the show notes. If you listen to the episode or take a look at the source files, you’ll see how it works!

The components below are included solely so you can see how the docstrings work with each kind of thing. Make sure to click on the names of the items: there is more documentation there. Again, take a look at the source to see how it looks in the context of a file module.

Note that this module-level docstring uses //! rather than ///-style comments. This is because this docstring is documenting the item which contains it, rather than the following item. Per Rust RFC 505, the preferred approach is always to use the “following” form (///) rather than the “containing” form (//!), except for module-level docs like these. (I will be following RFC 505 throughout.)



  • This is a sample structure, to demonstrate rustdoc/cargo doc.