When to use doc(hidden)

I think lazy_static does a nice job of this. How about a guideline to be mindful that formal rustdoc is supposed to include everything users need to use the crate fully, and nothing more. Okay to explain implementation details in prose (like lazy_static does) but they should not be real entries in the documentation.