Skip to content

Conversation

@lsy3
Copy link
Contributor

@lsy3 lsy3 commented Nov 16, 2025

Description

Add XML/YAML launch file equivalents "Using ROS 2 Launch For Large Projects" tutorial.

  • Add XML and YAML equivalents for all Python launch files
  • Update tutorial with tabbed multi-format code examples

Fixes #6006

Did you use Generative AI?

Partially - Cursor AI Assistant for tutorial rephrasing and refactoring. Each generated line reviewed.

Additional Information

  • broadcast_listener_launch.py renamed to broadcaster_listener_launch.py for correctness for launch file name
  • Only made changes to Tutorials/Intermediate/Launch/Using-ROS2-Launch-For-Large-Projects.html. If 📝 Replace all trivial launchfile examples with XML/YAML #6006 includes changes to tf and urdf tutorial, they will be done so in a separate PR.

lsy3 added 5 commits November 17, 2025 02:55
Update launch_turtlesim_launch.xml to use <let> for passing values
in include statements, with a note about earlier launch system
version compatibility requiring <arg> instead.

Signed-off-by: Luke Sy <[email protected]>
@lsy3 lsy3 marked this pull request as ready for review November 18, 2025 18:40
Copy link

@SuperJappie08 SuperJappie08 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good.

The only possible thing I could find with a (somewhat) quick scan was the missing emphasize lines for turtlesim_world_3_launch.py


.. literalinclude:: launch/turtlesim_world_3_launch.py
:language: python
:emphasize-lines: 12

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe add the emphasis to all formats.
Or migrate to push-ros-namespace (with the additional hassle of it currently needing to be explicitly scoped with a group when included).

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@SuperJappie08 Thanks for the review!

  • Emphasis added to the XML and YAML snippets so all formats highlight the namespace.
  • I think we can keep the current approach—“PushROSNamespace” comes later in section 3, and introducing it here in section 2 may disrupt the flow.

@lsy3 lsy3 requested a review from SuperJappie08 November 26, 2025 15:52
Copy link

@SuperJappie08 SuperJappie08 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good.

I wonder if somewhere it should mention that you can mix launch file types.
(This might not be the place for it, and it might already be mentioned somewhere else; I'm not fully up to date with the documentation improvements)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

📝 Replace all trivial launchfile examples with XML/YAML

2 participants