1 unstable release
0.1.0 | Dec 4, 2022 |
---|
#2059 in Development tools
15KB
Wonderful rustdoc
This project showcases how to write documentation with rustdoc
.
To get started, run cargo doc --open
and follow the instructions.
This project is part of the Rust Berlin online meetup.
lib.rs
:
What is rustdoc
?
rustdoc
is a tool to convert Rust code into documentation.
It can be used standalone, but most likely you want to invoke it from cargo
:
cargo doc --open
The above command generates the documentation and opens it in a browser.
Why rustdoc
?
Most public code needs documentation on how to use it.
While rustdoc
can generate a lot of documentation by itself,
it is still necessary for humans to provide additional information.
How to use rustdoc
?
You add special documentation comments in your source code.
If you want to write documentation for a module,
you insert documentation lines that start with //!
to describe the module file itself.
You can check out how it is done for this module,
by clicking on the link with the text "source" at the top right of the page.
Tell me more
Have a look at the [codeblocks] module.
Dependencies
~0.6–1.4MB
~28K SLoC