this post was submitted on 28 Jan 2024
898 points (97.7% liked)
Programmer Humor
32453 readers
829 users here now
Post funny things about programming here! (Or just rant about your favourite programming language.)
Rules:
- Posts must be relevant to programming, programmers, or computer science.
- No NSFW content.
- Jokes must be in good taste. No hate speech, bigotry, etc.
founded 5 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
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.