Update docs

[adamkrawczyk]

Bug report

Required Info:

• Operating System:
  • ubuntu 18
• Version or commit hash:
  • website
• DDS implementation:
  • cyclone dds

Steps to reproduce the issue

Just follow steps at the website to launch demo navigation with turtlebot3

https://ros-planning.github.io/navigation2/getting_started/index.html

Expected behavior

Turtlebot driving autonomously

Actual behavior

No launch file. Launch file provided with the package doesn't work.

Additional information

After launching simulation ros2 launch nav2_bringup nav2_simulation_launch.py there is no map.

[shivaang12]

Hi @adamkrawczyk I was wondering where are you looking for maps? In Nav2's repo or Turtlebot's repo?

I think you have to provide map through cli argument like for example

ros2 launch nav2_bringup nav2_simulation_launch.py map:=path/to/map

I suggest you to look (here)[https://github.com/ros-planning/navigation2/blob/master/nav2_bringup/bringup/README.md] for how to pass params.

And for the map, you can find prebuild map in nav2_bringup package under map directory.

[SteveMacenski]

Nav2 simulation launch is circa dashing. Where did you find instructions to use that?

The directions should tell you to use tb3_simulation.py.launch for Eloquent and newer.

@shivaang12 not sure what you mean by maps wrt launch files not running

[adamkrawczyk]

I'm just saying that the provided command doesn't work. Rest of the demo works fine.

[SteveMacenski]

Where did you find that command, specifically?

I’m looking at the website and I can’t find a reference to that launch file.

[adamkrawczyk]

https://ros-planning.github.io/navigation2/getting_started/index.html

Here is the command. Also I've checked source now and got that command is correct but the binary version for dashing doesn't come with specified launch file.

So this should be more like 'update binary version for dashing'

I have only

/opt/ros/dashing/share/nav2_bringup/launch$ ls

bt_navigator.xml        nav2_localization_launch.py  turtlebot3_world.pgm
gazebo_rviz2_launch.py  nav2_navigation_launch.py    turtlebot3_world.yaml
nav2_bringup_launch.py  nav2_params.yaml
nav2_default_view.rviz  nav2_simulation_launch.py

[shivaang12]

@adamkrawczyk Sorry, I think I miss understood you before. tb3_simulation_launch.py was introduced later after Dashing release.

@SteveMacenski Can we cherrypick this thing? or not?

[SteveMacenski]

That page is for Eloquent and newer, we changed that launch file right after the dashing release to better describe its function. Sorry if that caused you trouble; we've been recommending users to use Eloquent or ROS2 master since Dashing is a little buggy and it was massively improved in Eloquent.

I'd welcome a PR from you though at https://github.com/ros-planning/navigation.ros.org to add a "Note:" about if using dashing or older, use the nav2_simulation_launch.py file. You're now the second new user to mention that issue and we should address it. You can find the source for that specific page here.

[adamkrawczyk]

Okay, thank you. I’m closing now