What tools do you use to build the documentation?
The Home Assistant website is a Jekyll site. The pages are written in Markdown with some Liquid templating, the source is hosted on GitHub, and the site is built and deployed by Netlify.
This setup works well for an open-source project: every page has an Edit this page on GitHub link, so anyone can suggest changes through a pull request without needing to learn a separate publishing platform.