3 ms·
Rust uses markdown (with some extensions) for its documentation. This has some limitations, and there was a discussion [1] about changing this to RST a while ag
by mastax 11y ago
Rust uses markdown (with some extensions) for its documentation. This has some limitations, and there was a discussion [1] about changing this to RST a while ago, but it never happened.
[1]: https://internals.rust-lang.org/t/rustdoc-restructuredtext-vs-markdown/356 https://internals.rust-lang.org/t/rustdoc-restructuredtext-v...
- steveklabnik 11y agoThe only real issue I have with it is manually creating links to other things, which is tedious and error-prone. I'm hoping to transition us to CommonMark, and with it, an extension that can do this.