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 loudmax on Tuesday November 22, 2022 @03:26PM (#33711003)
This is what the Gitlab wiki does. There's a markdown+git interface for technical folks and a web interface for normal people.
[ Parent | on HN ]
Re:The Perks of a High-Documentation, Low-Meeting Work Culture by mgbmtl on Tuesday November 22, 2022 @07:48PM (#33713648)
It's what we use, and what I find the be the less annoying solution, but there are two big show-stoppers to make it more user-friendly:

- the default index on the sidebar doesn't handle sub-directories well (https://gitlab.com/gitlab-org/gitlab/-/issues/17673) - we use a pipeline to refresh an index page, but it's duct-tape and annoying to setup.

- can't edit only a section of a page, so if the page has a few sections, I often lose track of what exactly I wanted to change (maybe the WYSIWYG helps here, have to admit I have not used it much)

Otherwise I like that each project has its wiki, and so instead of one huge messy wiki, it's a few smaller messy wiki, easier to cleanup and have clear owners.

[ Parent | on HN ]