🎉 Gazebo Jetty Test and Tutorial Party Instructions

Hi Gazebo community,

As mentioned previously we’ll be conducting a testing and tutorial party for the next Gazebo release, Jetty. If you missed the kickoff meeting for the tutorial party, here’s the video:

:television: [Video Link]
Slides: JettyTutorialParty.pdf (2.5 MB)

We’ll be partying from August 27th until Friday, September 11th, 2025. As a reminder, to sweeten the pot, we will once again be sending out Jetty t-shirts :t_shirt: or OSRA membership to the top twenty tutorial party animals (those who finish reviewing the most tutorials as measured by a new points system). Since the t-shirts will be distributed as gift codes to the Gazebo Swag store :backhand_index_pointing_right: you must fill out this form after you close your first ticket (Gazebo Jetty Test & Tutorial Party Swag Signup Form) :backhand_index_pointing_left: Additionally, every single one of the tutorial participants will be included in the Jetty release notes. Unfortunately, we’re still working on the Gazebo Jetty artwork, so our Gazebo store isn’t quite ready yet, but we should have that up before the end of the Tutorial Party.

Important Dates :tear_off_calendar:

  • 2025-08-27 → 2025-09-11 Jetty Tutorial Party
  • 2025-09-15 → 2025-09-29 Internal Q&A
  • 2025-09-24 Community Meeting Demo
  • 2025-09-30 Official Release Announcement
  • 2025-10-07 Tutorial Party top contributors announced
    (potentially earlier)
  • 2025-09-30 Official Release Announcement
  • TBD Graphic Release and T-Shirt Sale – (T-shirt / art will be delayed)

How to Party! :tada:

The party process is fairly simple, and if all goes according to plan you should be able to validate a few tutorials in an hour or two and check out some recent upgrades to Gazebo. We’ll be using the issues in this Github repository to track our progress as we’ve created an automated system for generating all of the different tutorials we need to review. Here are the steps (to party):

  • Pick a tutorial flavor by filtering out the Github issues using the corresponding labels. The Readme will be a good starting point and has some helpful tips on how to filter Github issues. Note that the Jetty release supports two installation methods (source and binaries) and a few host operating systems (Ubuntu Noble, Windows, MacOS Monterey, and Ventura).
  • Install the pre-releases on your computer (we’ve included directions for each host operating system below, but they are all listed here)
  • Make sure to check out the troubleshooting page if you run into any issues.
  • Find an open issue from the Gazebo testing repository and comment on the issue stating that you would like to test the tutorial contained in the issue.
  • Run through the tutorial from start to finish! Be really thorough; if you think you could improve the tutorial feel free to add to it. At this point one of three things will happen:
    • The tutorial works perfectly!
      • Close the issue with a comment that everything works as expected.
    • The tutorial has issues…
      • But, you can fix them and send us a PR.
        • Open the PR and drop a link on the issue.
      • You can’t fix them (that’s ok!)
        • Post a comment describing the problems you faced.
        • Include as much information as you can (logs, screenshots, terminal output, etc).
  • If you’re doing a tutorial that works with ROS, make sure to follow the ROS integration testing instructions. [Pending, stay tuned]
  • If you don’t have Ubuntu Noble installed natively, we’ve provided Dockerfiles and instructions to do the tests using Docker.
  • Make sure to :backhand_index_pointing_right:fill out the registration form after you close your first ticket.:backhand_index_pointing_left:
  • Try another tutorial!

:new_button: New for Jetty – A Points System

This year we’re changing how we rank contributions to the T&T party. In previous years we’ve ended the T&T party with a few tickets remaining, often for less popular operating systems, and we would like to change that. Here’s how the new system works:

  • All tickets are now assigned a certain number of points.
  • The total number of points awarded to each contributor will be periodically updated on a leader board in the testing repo.
  • We have three tiers of tagged issues:
    • Issues tagged “hard” get 18 points.
    • Untagged issues get 12 points.
    • Issues tagged “easy” get 6 points.
  • Less frequently tested issues, usually on Mac and Windows, get a 20% multiplier. For example, a “hard” issue on Mac is worth 18*1.2=21.6.
  • The number of points for an issue decreases each time the ticket is completed. This decrease is calculated by taking the base value and dividing it by the number of times the issue has been tested. For example, take an 18 point “hard” ticket:
    • If only one person completes the ticket they get 18/1=18 points
    • If two people complete the ticket each person gets 18/2=9 points
    • Lastly if three people complete the ticket each person gets 18/3=6 points
    • Any more completions past the third do not count for points
  • You can sort in advance the level of completion of existing issues with the labels “not-started”, “completion-1”, “completion-2”, and “completion-3”
    • Note that once an issue is tagged with “completion-3” there are no more points to be earned from it.
  • You can claim completion by sharing proof and including on a new line at the end of the comment either “[status: passed]” or “[status: failed]”
    • Upon completion, if you are among the first 3 completers, you will be assigned to the issue and the relevant points will be added to your cumulative score

Need Help? :raised_hand:

If you find yourself in a pickle don’t worry, we’ve got you covered! Our recommendation is that you first comment in the ticket you are working on and ping a member of the core team. Alternatively you can bring your questions to the #gazebo-help channel on our Discord server. If you have general T&T party questions feel free to ask them below. Otherwise, here are some helpful resources if you get stuck:

Installing Pre-releases

All Jetty libraries have pre-releases. The following installation methods are available:

2 Likes

I think this link is broken.

Enjoy the party everyone !

ROS Integration isn’t up just yet. I’ll update when it goes live. The information will appear on the T&T repo as soon as it is ready.

2 Likes

Youtube link

1 Like