3 ms·
A lot depends on your target audience, type of documents you are creating, and also who the people writing the content are. There is no "best" documentation sy
by zapperdapper 8y ago
A lot depends on your target audience, type of documents you are creating, and also who the people writing the content are.
There is no "best" documentation system really, only what's best for your requirements. For example, in some cases DITA XML may be absolutely the best choice, in other cases LaTeX makes more sense, it just depends.
If you are documenting APIs take a look at OAS3.
Cross Word off your list unless you needs are very small scale - even Microsoft use Markdown/GitHub for their tech docs these days.
Personally, I would probably go for Markdown/GitHub/GitLab and use some third party tools for TOC generation. A static doc site generator like Docusaurus[1] might provide what you need. But as I say difficult to tell without knowing all the details. Good luck!
[1] https://docusaurus.io/ https://docusaurus.io/