forked from rust-lang/rust
-
Notifications
You must be signed in to change notification settings - Fork 4
Bikeshed rustdoc
Corey Richardson edited this page Jul 4, 2013
·
12 revisions
rustdoc currently needs some love, and I (cmr) am going to give it some.
- take AST, make pretty docs. easy!
-
Implementation of Foo for Bar where <useless stuff>(from SL. where -> given?)
- Unformatted JSON/XML (undecided) output
- More complete TOCs, indexes, links to all items documented
- Interactive browser interface (live search, toggle platform cfg's)
- every symbol should be able to be linked to its documentation (eg, types, methods, functions)
- new attribute that instructs rustdoc to inline a nested module into its parent's documentation
- document macros
- navigate visibility graph and don't generate docs for stuff which isn't visible
- document macro-generated code
- link to source
- "a cross-reference with a list of all traits declared in all modules would be very useful. Developers, particularly people writing libraries, would have a big "to-do" list of all the traits their new types could implement."
- your feature requests here!
- your bug requests here!
- this will track pull requests and status updates as I create them.