Looking over https://wikitech.wikimedia.org/wiki/Lists.wikimedia.org - it needs to be changed.
A few main points;
- Disable lists section skips the mailman interface as the main method of doing this. The method listed is mostly damaging, causing inconsistencies and so on. Ops can disable a list via shell but the method list is a mix of correct and breaking. Re-enabling the list fixes it however.
- Configuration section is just giving a 'wow so out of date' vibe. Just like to puppet at the very worst case anyway. Let's not dupe things twice.
- Seems to be a working pad for lily->sodium too. Not the best when we're working on sodium->fermium right now :)
- Probably set up a user-side documentation as well. Technical docs are great but when they are the only source of information for things like spamassassin, it's terrible linking people to it.
In short; rewrite everything and get bad practice out of people. It does more harm than good.