I often find when writing code that I want to introduce "sections"
into my file. Typically I do this like:
////////////////////////////////////////////////////////
// Node construction
//
// Methods for constructing new nodes.
I find this helpful when browsing through the code. I imagine
something similar would be helpful when browsing through rustdocs.
Maybe we can find a way to incorporate some sort of "section"
to use when grouping items, methods, fields, etc. I imagine
we could draw on Markdown's `#`, `##`, `###` notation to
define sections, subsections, and so forth, but I'm just
not sure how we would let rustdoc know about it, since there
is nothing in particular to attach the attribute to.
Any thoughts? Is this something other people would like?
Niko
_______________________________________________
Rust-dev mailing list
[email protected]
https://mail.mozilla.org/listinfo/rust-dev
