This repository contains the sources for the ROS 2 documentation that is hosted at https://docs.ros.org/en. The sources from this repository are built and uploaded to the site nightly by a Jenkins job.

Contributions to this site are most welcome. Please see the Contributing to ROS 2 Documentation page to learn more.

To contribute to the ROS 2 source code project please refer to the ROS 2 contributing guidelines.

To build this you need to install

• make
• graphviz
• python virtualenv

In the virtualenv

pip install -r requirements.txt -c constraints.txt

For development we currently use Jammy as our build platform. And all python versions are pinned in the constraints file to make sure that things are reproducible. To upgrade the system validate that things are working and then use pip freeze > constraints.txt to lock in the versions to upgrade.

For local testing of the current tree use:

make html

sensible-browser build/html/index.html

To test building the multisite version deployed to the website use:

make multiversion

sensible-browser build/html/rolling/index.html

NB: This will ignore local workspace changes and build from the branches.