Ask HN: How to maintain a killer product documentation page

  • We generate a static website using Hugo and a documentation theme. [1] Non-technical members of our team can use Markdown easily and publish changes on their own schedule thanks to a very simple but sturdy CI/CD setup (GitHub Actions and NGINX).

    Stripe's documentation is way over-engineered and wasteful IMO, and probably requires a massive team to maintain.

    [1] https://github.com/alex-shpak/hugo-book

  • It's all about putting in the work. Not much programming expertise required.

  • Good content and a good TOC.