Incorrect repository link in documentation – rosbot_xl_ros appears deprecated

Bugs
1

Hi!
While following the tutorial “1. ROS 2 Introduction” I found an issue in the section:

1. Create the workspace and clone rosbot-ros repository

The instructions are:

mkdir -p rosbot_ws/src
cd rosbot_ws
git clone https://github.com/husarion/rosbot_xl_ros src/

However:

:cross_mark: Problem

The documentation says “clone rosbot-ros repository”, but the link points to rosbot_xl_ros, which appears to be deprecated / not maintained.

When using this repo, several problems occur:

  • missing .repos files (rosbot_xl_hardware.repos, rosbot_xl_simulation.repos)

  • rosdep failing with dependencies like open_manipulator_description

  • missing or outdated packages required by Gazebo and ROSbot simulation

  • installation workflows in the tutorial no longer match the contents of rosbot_xl_ros

This leads to repeated build errors and dependency resolution failures.

:white_check_mark: Expected

The tutorial should point to the maintained repository, which seems to be:

https://github.com/husarion/rosbot_ros

:pushpin: Suggestion

Please update the documentation to avoid confusing new users. Using the deprecated rosbot_xl_ros repo makes the tutorial impossible to follow.

Thanks!

2

Hello @nikevdp,

Thank you for bringing this to my attention. It’s true that the information in the tutorials is a bit outdated (humble instead of jazzy), and the rosbot_xl_ros repository has been moved to rosbot_ros. However, I have serious doubts about the source of the errors you reported. There is indeed one dependency (ros_components_description) that prevents the repository from being used, but it’s nothing like what you’re describing.

Problem

Regarding problematic issues, several require clarification.

  • missing .repos files (rosbot_xl_hardware.repos, rosbot_xl_simulation.repos)

The old repo it is not maintained, but it still works and vcs files are available.

  • rosdep failing with dependencies like open_manipulator_description

open_manipulator_description is not a dependency of rosbot_xl_ros repo. Probably you have another package in your repo. Please clean your workspace or create new one.

ROS Tutorial for Jazzy

A separate issue is the need to update these articles to include the Jazzy version. While the initial tutorials are based primarily on ROSbot data, so it should work equally well on humble and jazzy (with major changes to the ROSbot driver API beetween Humble and Jazzy). Problems may arise in later articles where external packages (such as slam and nav2) are used.

Suggestion

Soon I will apply this suggestion on the page.

Regards,

3

Thanks for the reply, and sorry if any of the information I shared was incorrect — I’m new to the ROS2 world.
In the end, to get the robot working in Gazebo I installed some missing dependencies that were causing errors, and I also switched the branch of ros_components_description to husarion_components_description. After updating the files that referenced it, everything ran correctly.
I suppose that later I might move to Jazzy if I need it.