ros2/ros2_documentation

ROS 2 docs repository

What it solves

This repository serves as the central source for the official ROS 2 documentation. It provides the files and build instructions necessary to generate the documentation website hosted at docs.ros.org.

How it works

The project uses Sphinx to convert source files into a browsable HTML website. It includes tools for local development, such as live-reloading to see changes instantly, automated spelling checks, and the ability to build multiple versions of the documentation to match different ROS 2 releases.

Who it’s for

This repository is for contributors and maintainers who want to improve, update, or test the official ROS 2 documentation before it is published to the live site.

Highlights

  • Supports live-reloading for rapid documentation iteration.
  • Includes automated spelling checks with custom whitelist and dictionary support.
  • Enables local testing of the multi-version documentation structure.
  • Optimized for parallel builds to speed up processing time.
  • Provides clear instructions for setting up reproducible development environments using Python virtual environments.

Related

  • Project
  • Project
  • Project
  • Project