4 ms·
Tl;dr: "Good documentation is all about the semantic markup." Well, ok, I'll buy that. "What to use instead: LaTeX. [Just kidding.] A better answer is reStruc
by mcguire 7y ago
Tl;dr: "Good documentation is all about the semantic markup."
Well, ok, I'll buy that.
"What to use instead: LaTeX. [Just kidding.] A better answer is reStructuredText or RST. [Or AsciiDoc.]"
Er, well, ... RST does have extension syntax that allows you some flexibility to use semantic markup, but then the tools all have to understand the extensions you use. LaTeX at least has the ability to define the meaning of your extensions in its own syntax, but that is not all that much fun.
Conclusion: Everything sucks. Sorry.