News for hackers. Stuff that matters.
Re:Ask HN: How do you organize software documentation at work? by globallyunique on Wednesday February 14, 2024 @12:15PM (#39372341)
I like the idea as an engineer - but this makes it so non-technical people are less likely to write docs. If your marketing manager needs git access and to edit a markdown file on GitHub - the chance they will document in even ideal conditions goes way down
Re:Ask HN: How do you organize software documentation at work? by cdchn on Wednesday February 14, 2024 @02:41PM (#39374217)
I think this is a valid concern, and it seems that most code oasis implementations are starting to add web interfaces for editing files in Git. And a WYSIWYG Markdown editor that can post MRs for people who don't have the ability to directly commit and you're pretty much at Confluence territory (when you have a pipeline to build a doc site with search, that is)