News for hackers. Stuff that matters.
Re:Don’t Use Markdown for Documentation by mastax on Tuesday March 15, 2016 @07:05PM (#11293730)
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-v...

Re:Don’t Use Markdown for Documentation by steveklabnik on Tuesday March 15, 2016 @09:36PM (#11294390)
The 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.