Hacker News new | ask | show | jobs
by caspar 1627 days ago
Also an Atlassian here. For anyone wondering, we tend to use Confluence for planning, decisions, team process, tech specs, etc but use an internal view of DAC[0] for code docs. Think Hugo[1] crossed with redoc[2] with a dash of GraphQL support.

Unfortunately the docs-in-repo + PRs-for-updates approach has way more friction for drive-by-corrections/commentary/Q&A from people not on the team, so it's not a holy grail either.

    [0]: https://developer.atlassian.com/cloud/
    [1]: https://gohugo.io
    [2]: https://github.com/Redocly/redoc