gz-gui icon indicating copy to clipboard operation
gz-gui copied to clipboard

Plugins tutorial should be improved to be more new user friendly

Open azeey opened this issue 1 year ago • 5 comments

          * **Test enviornment**
```text
CPU: Ryzen 5 5600x, Ram: 32GB @ 3200 Mhz, GPU: RTX 3080
Clean copy of Ubuntu 24.04 Humble
ROS 2 Jazzy Jalisco full desktop
```
  • Summary
    • In my humble opinion this tutorial may need to be presented in context of a more hands-on example. The current version was hard to follow, specially as a newcomer to Gazebo.
    • Add a note stating if built from source, GZ_GUI_PLUGIN_PATH can be set as follows
    cd ~/workspace/src/gz-gui
    export GZ_GUI_PLUGIN_PATH=${HOME}/workspace/src/gz-gui
    echo $GZ_GUI_PLUGIN_PATH
    gz gui -s ImageDisplay
    
    • Tutorial does not show how to set GZ_GUI_PLUGIN_PATH. Nor it states the user had to change direcotry into src/gz-gui directory before this command would work correctly

Screenshot from 2024-09-05 20-48-49

Screenshot from 2024-09-05 20-49-39

  • Issues
    • Users needs to change directory to ~/workspace/src/gz-gui. Without this step, invoking any of example commands with gz gui -c prefix throws XMLError error.
    • The tutorial page has multiple \subpage references that leads to nowhere.
    • Commands for Topic Viewer, Topic Stats, Requesters and Responders did not work.

Screenshot from 2024-09-05 20-56-10

Originally posted by @Mechazo11 in https://github.com/gazebosim/gazebo_test_cases/issues/1323#issuecomment-2333043686

azeey avatar Sep 16 '24 22:09 azeey

Interested to take this up.

anshium avatar Mar 27 '25 00:03 anshium

sure, please go ahead!

iche033 avatar Mar 27 '25 17:03 iche033

@ahcorde, heads up.

kscottz avatar Mar 27 '25 21:03 kscottz

@anshium How are things going here? Do you need some help?

kscottz avatar Mar 31 '25 18:03 kscottz

I am sorry, I was unwell and occupied with a few important things in the last few days. I would soon create a PR.

Apologies for the delay.

anshium avatar Mar 31 '25 19:03 anshium