> In the real world, people use Microsoft Word, or even LibreOffice Write.
Please point to towards an API or library documentation written in the native format of either of those. In 10 years as a developer, I've never come across such a thing.
> Yet another flavor of Markdown is not helping.
Agreed. That's pretty much what the article states, and RST, luckily, is not that.
The C# and PowerShell specifications are written in Word ;)
In any case, there's a lot of things people use in-house and never bother to tell the outside world about, and you'd be surprised how far that is from what people on HN or Github habitually use.
