# 1 repository
Where does the code live? One entry registers one repository.
Each distro is its own registry file. Register once per distro you support.
The entry's key in the registry: lowercase letters, digits, _ or
-. Suggested from the URL; it never has to match a package name.
# 2 ref
Which state of the repository should Autoware validate? One ref per entry: every registered package is built and tested at it, in lockstep.
# 3 packages
Which ROS packages are you registering? Each name must equal a real
package.xml <name> at the ref above; the sweep resolves
every one with colcon list and fails loudly when a name is absent. If a
package requires another package already registered for this ROS distro, the page
detects it from package.xml and includes its Index source automatically.
Other dependencies are resolved by rosdep during the build.
# 4 maintainers
Who can a reviewer talk to about this repository? At least one real person; CI rejects
TBD and @example.com placeholders.