News for hackers. Stuff that matters.

A comment on The Perks of a High-Documentation, Low-Meeting Work Culture. Parent comment

Re:The Perks of a High-Documentation, Low-Meeting Work Culture by joegahona on Tuesday November 22, 2022 @03:27PM (#33711016)
> 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?

[ Parent | on HN ]
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by vasco on Tuesday November 22, 2022 @03:30PM (#33711051)
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.
[ Parent | on HN ]
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by bratbag on Wednesday November 23, 2022 @02:14AM (#33716143)
Even poor discoverability can be fixed with labels.

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

[ Parent | on HN ]
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by WorldMaker on Tuesday November 22, 2022 @03:38PM (#33711155)
There are Wiki-like interfaces for git+Markdown: GitHub's wikis, gitit, and more.
[ Parent | on HN ]
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by otikik on Tuesday November 22, 2022 @03:31PM (#33711069)
Google Docs
[ Parent | on HN ]