Ask HN: How are you writing documentation? What tools do you use?
We've long struggled with documentation. Both structured documentation and Q&A. We've kept our structured documentation in a github repo in the past, but it's been a challenge to get people to write it and keep it up to date consistently. And people often forget it's there when they have a question they need answered.
Q&A just happens in a slack channel right now, but that makes it ephemeral for all practical purposes. Slack search just wasn't built for this, and no one wants to wade through a slack back and forth to try to find the answer to their question.
We have Guru that we use for policy documentation, HR, sales/marketing, etc. But it's never felt like a good fit for technical documentation. We're considering trying it anyway.
We're also looking at Stackoverflow Teams for its Q&A functionality, and possibly using Articles for structured. But Articles seems pretty weak.
What else is out there? This is purely internal documentation for us, so we'd like it authentication protected and we're not keen to build our own system using something like Markdown Docs or Sphinx. And we're wary of wikis due to their tendency to decay towards choas - we're already struggling a bit to keep our documentation well organized in Github and Guru. Hence, we've avoided Confluence.
What is everyone else using? What other tools are out there? Does anyone feel like they've really solved the documentation problem? If so, how?