Documentation confluence vs Git
Hey everyone,
So hear me out. Document Rot is real.
We have all seen it.
The techniques of the past (for non Devs) relied on people documenting in office, slides, confluence, wikis or whatever and keep that up to date.
I never saw that working. Quickly it became a massive junk of unmaintained stuff.
AI changes the game.
In one repo, you can now keep a consistent documentation where all relevant changes can be added.
The issue? For Developers, especially in OpenSource: zero.
For non-Devs, this is a pain.
How are they now supposed to read and comment? Using GitHub and PRs is naturally a really good system, however for people that are used to WYSIWYG it feels off… plus having to use a coding environment if at all.
I am personally adding GitHub Pages to make the repo visible as a page with a comment system, and even then you get that friction.
Any better 2026 and beyond practices out there? (Note. One project docs are easy. This impacts multi -repo projects)