As long as it’s clear in the wiki as to what version the documentation is referring to, i’d prefer it to live there. When docs live in the code, they tend to not get updated as much due to:
- developers wanting to just contribute code, not words, to the software
- reviewers not wanting to block PRs due to a lack of updates to documentation
- non-devs wanting to update the docs not having the git-fu necessary to update docs
I mentioned in @robert.down’s Documentation Migration Strategy that “In the future, i hope that we can provide this documentation as a part of the user’s workflow.”
An easy bridge between in-line help and docs that live on mediawiki is a target="_blank" href that opens up the relevant feature documentation.
Edit: grammar