[ros-users] Documentation jobs

[Dirk Thomas]

Until now when a doc job was unable to fetch the specified repository and branch (as specified in https://github.com/ros/rosdistro/blob/master/hydro/doc.yaml) the build farm was unable to notify the 
maintainers.
Since it could not check out the code it was not possible to extract the maintainer information from the manifests and therefore it was unknown who to notify about the failure (except the common 
receiver ros-buildfarm-doc at googlegroups.com).

At least in the case that only the branch does not exist but the url is still a valid repository this has been improved.
If the specified checkout fails the doc jobs will fall back to the default branch just in order to determine the maintainers (even if these information might come from a different branch / ROS distro).

So if your to-be-documented ROS package has a non-existing branch specified in the rosdistro file you will start receiving emails about failing documentation jobs (every three days, which is the 
interval each doc job is executed).
If that happens please update the entry in the rosdistro file to a valid branch using a pull request on https://github.com/ros/rosdistro.

Cheers,
- Dirk