2 ms·
1. Store your documentation in github wikis, not in Confluence (Confluence is slow to load. It's WYSIWYG editor is somehow as good as a simple markdown editor.
by phendrenad2 6y ago
1. Store your documentation in github wikis, not in Confluence (Confluence is slow to load. It's WYSIWYG editor is somehow as good as a simple markdown editor. It's hard to find things. It becomes a big dumping ground. Write-only documentation. By using github wikis, the documentation lives where the code lives.)
2. Don't put documentation in git. Just don't. No one will contribute to it. It'll require code review to check in a typo fix.
3. Let anyone contribute.
4. Encourage junior developers to fix bad documentation. Senior devs won't do it, they think it's beneath them. Junior devs might think it's above them. Empower them to do it.