3 ms·
> Writing and aggregating good documentation needs to be easy and simple. Gating documentation behind git is the opposite of that for non technical people. How
by joegahona 4y ago
> Writing and aggregating good documentation needs to be easy and simple. Gating documentation behind git is the opposite of that for non technical people.
How do you find a happy medium between this and a Confluence-like free-for-all, where anyone can create/edit a page?
- vasco 4y agoMost of the issues with Confluence I've seen are lack of organisation, out of date information mixed with up to date pages and really poor search / discoverability. The fact that people can just edit or create a page at any point is one of the better parts because it's easy for someone to fix something up during onboarding, during a drive-by consultation etc.
- bratbag 4y agoEven poor discoverability can be fixed with labels. But yes, the out of date info is a killer.
- otikik 4y agoGoogle Docs
- WorldMaker 4y agoThere are Wiki-like interfaces for git+Markdown: GitHub's wikis, gitit, and more.