Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

> 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?



Most 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.


Even poor discoverability can be fixed with labels.

But yes, the out of date info is a killer.


There are Wiki-like interfaces for git+Markdown: GitHub's wikis, gitit, and more.


Google Docs




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: