Rolling rosdistro

[SteveMacenski]

Adds a how-to guide for setting the rosdistro index in the context of rolling breakages on OS transitions

[ros-discourse]

This pull request has been mentioned on ROS Discourse. There might be relevant details there:

https://discourse.ros.org/t/psa-rolling-ci-or-docker-build-fix-from-rosdep-errors-in-24-04-transition/36902/1

[fujitatomoya]

@SteveMacenski quick question. is this just a temporary documentation to support the transition period for rolling from 22.04 to 24.04? it looks really specific for this transition period. i was thinking this could be more useful and general, but relevant from specific transition period? (i can feel your pain here... 😅 )

[SteveMacenski]

is this just a temporary documentation to support the transition period for rolling from 22.04 to 24.04?

It also covers 24.04 to 26.04, and so on. But yes, this is targeting for handling during transition periods, but as I mention a couple of times in the document, could be used for your own specific rosdistro needs (this is just the motivating example I'm How-To-ing on).

I prefer non-abstract examples so someone can understand in a particular context what to do. I find it easier to read and mentally insert my own problem set rather than just saying OS-X to OS-Z and keeping things so general that it makes the language hard to follow. Given that this is in the How-To section of the website, that feels like the appropriate diction anyway

[clalancette]

In short, this is great documentation. I think having a motivating example here works for me.

I've left a few minor typos inline and such, but otherwise I think this is good.