Update docker instructions

[christophfroehlich]

Using the sphinx tabs plugin, we could improve the instructions using the docker container.

Choosing one tab switches all group-tabs at once (as known from docs.ros.org). What do you think? Did that only for example 1, but would apply the changes to the others, too.

[olivier-stasse]

LGTM and tested.
This a nice addition.
I had to battle a little bit to understand how to build the documentation in a stand-alone mode. I will try to propose a PR on control.ros.org.

The way it was tested was to modify the script make_help_scripts/deploy_defines specifying the repo and the branch

[christophfroehlich]

what was the problem with spinhx? I always clone the three subrepos manually or create symlinks into the folder.

[olivier-stasse]

I simply changed

declare -A subrepo_url=( ["ros2_control"]="https://github.com/ros-controls/ros2_control" ["ros2_controllers"]="https://github.com/ros-controls/ros2_controllers" ["ros2_control_demos"]="https://github.com/ros-controls/ros2_control_demos" ["gazebo_ros2_control"]="https://github.com/ros-controls/gazebo_ros2_control" ["gz_ros2_control"]="https://github.com/ros-controls/gz_ros2_control")
declare -A subrepo_pr=( ["ros2_control"]=$ROS2_CONTROL_PR ["ros2_controllers"]=$ROS2_CONTROLLERS_PR ["ros2_control_demos"]=$ROS2_CONTROL_DEMOS_PR ["gazebo_ros2_control"]=$GAZEBO_ROS2_CONTROL_PR ["gz_ros2_control"]=$GZ_ROS2_CONTROL_PR)

to

declare -A subrepo_url=( ["ros2_control"]="https://github.com/ros-controls/ros2_control" ["ros2_controllers"]="https://github.com/ros-controls/ros2_controllers" ["ros2_control_demos"]="https://github.com/christophfroehlich/ros2_control_demos" ["gazebo_ros2_control"]="https://github.com/ros-controls/gazebo_ros2_control" ["gz_ros2_control"]="https://github.com/ros-controls/gz_ros2_control")
declare -A subrepo_pr=( ["ros2_control"]=$ROS2_CONTROL_PR ["ros2_controllers"]=$ROS2_CONTROLLERS_PR ["ros2_control_demos"]=improved_docker_description ["gazebo_ros2_control"]=$GAZEBO_ROS2_CONTROL_PR ["gz_ros2_control"]=$GZ_ROS2_CONTROL_PR)

in
https://github.com/ros-controls/control.ros.org/blob/master/make_help_scripts/deploy_defines

no need to clone locally the subrepos as it is done by the script.

I failed to do it by hand...

[olivier-stasse]

Otherwise for this PR, if you fix the conflict file we can merge it.

[olivier-stasse]

LGTM - All tests are passing

[olivier-stasse]

@christophfroehlich sorry I fixed some minor issues and did this by commiting directy on your branch. Hope this is fine.

[christophfroehlich]

@Mergifyio backport humble

[mergify]

backport humble

✅ Backports have been created

• #365 Update docker instructions (backport #351) has been created for branch humble