I generally liked Python doctests: runnable documentation. It is really an amazing concept, only a step removed from literate programming IMO.
Two problems with it were that 1. often setup boilerplate overshadowed the actual essence of the documentation and 2. people abused them for e2e testing making for unreasonable reading (and slow testsuite runs).
7 comments
[ 1.4 ms ] story [ 20.9 ms ] threadplenty of tools to turn that into html if you want
confluence is bloated an unweildy
Jira done well is actually nice
Confluence is slow but pretty simple, standard wiki otherwise. Obviously, if I had a choice, it'd be nothing Atlassian.
git+markdown limits editing to developers only.
Two problems with it were that 1. often setup boilerplate overshadowed the actual essence of the documentation and 2. people abused them for e2e testing making for unreasonable reading (and slow testsuite runs).