What is blueos-docs?

This repository holds the written documentation for BlueOS, an onboard computer software platform made by Blue Robotics for underwater vehicles and drones. The docs themselves live at blueos.cloud and cover everything from setup guides to feature references. If you've ever needed help operating or configuring a BlueOS-powered robot, this is the source that feeds that help site. The documentation is built using a tool called Zola, which takes plain text files and turns them into a polished website. The visual styling comes from a separate design package called BlueTheme. The actual writing sits in a folder called content, so contributors don't need to worry about the look of the site, they just write the words and the tools handle the rest. The project is organized so that each minor release of the software gets its own branch. There's a latest branch for documenting features still in development and a stable branch for the current shipping version. This setup means someone reading the docs for an older version of the software won't accidentally see instructions for features that don't exist on their machine yet. Each version is built independently so its search results stay accurate to that release. The people who'd contribute here are BlueOS users, developers, or Blue Robotics staff who spot a gap in the documentation or want to explain a new feature. The workflow is straightforward: write it for latest first, then copy it over to stable when the feature officially ships. This keeps the docs in sync with the software release cycle without forcing a single document to serve every version at once.