Wikis always seem to produce second rate documentation, except maybe the ones that are designed specifically around software projects. There are any number of tools out there that produce better documentation and it can be stored alongside the source code in a git repository to avoid drift between the code and the associated documentation.
Wikis always seem to produce second rate documentation, except maybe the ones that are designed specifically around software projects. There are any number of tools out there that produce better documentation and it can be stored alongside the source code in a git repository to avoid drift between the code and the associated documentation.
They are only second rate if not used.
Your wiki can be hosted in a VCS. gitit I think is the original and as it uses pandoc it’s probably what you want to use. (Not so) random example wiki powered by it.
Two big advantages over plain text in VCS: You get to look at hyperlinked and whatnot output, and non-programmers can contribute.