docs: add apt update/upgrade to workspace install/update instructions (…

…autowarefoundation#615)

Signed-off-by: Max SCHMELLER <[email protected]>

docs/installation/autoware/docker-installation.md

@@ -90,11 +90,12 @@ Inside the container, you can run the Autoware tutorials by following these link
 
 2. Update dependent ROS packages.
 
-   The dependency of Autoware may change after the Docker image was created.
-   In that case, you need to run the following commands to update the dependency.
+   The dependencies of Autoware may have changed after the Docker image was created.
+   In that case, you need to run the following commands to update the dependencies.
 
    ```bash
-   sudo apt update
+   # Make sure all ros-$ROS_DISTRO-* packages are upgraded to their latest version
+   sudo apt update && sudo apt upgrade
    rosdep update
    rosdep install -y --from-paths src --ignore-src --rosdistro $ROS_DISTRO
    ```
@@ -114,6 +115,19 @@ Inside the container, you can run the Autoware tutorials by following these link
 > git pull
 > vcs import src < autoware.repos
 > vcs pull src
+> # Make sure all ros-$ROS_DISTRO-* packages are upgraded to their latest version
+> sudo apt update && sudo apt upgrade
+> rosdep update
+> rosdep install -y --from-paths src --ignore-src --rosdistro $ROS_DISTRO
+> ```
+>
+> It might be the case that dependencies imported via `vcs import` have been moved/removed.
+> VCStool does not currently handle those cases, so if builds fail after `vcs import`, cleaning
+> and re-importing all dependencies may be necessary:
+>
+> ```bash
+> rm -rf src/*
+> vcs import src < autoware.repos
 > ```
 
 #### Using VS Code remote containers for development

docs/installation/autoware/source-installation.md

@@ -89,6 +89,9 @@ sudo apt-get -y install git
 
    ```bash
    source /opt/ros/humble/setup.bash
+   # Make sure all previously installed ros-$ROS_DISTRO-* packages are upgraded to their latest version
+   sudo apt update && sudo apt upgrade
+   rosdep update
    rosdep install -y --from-paths src --ignore-src --rosdistro $ROS_DISTRO
    ```
 
@@ -136,10 +139,22 @@ sudo apt-get -y install git
 
    For more information, refer to the [official documentation](https://github.com/dirk-thomas/vcstool).
 
+   It might be the case that dependencies imported via `vcs import` have been moved/removed.
+   VCStool does not currently handle those cases, so if builds fail after `vcs import`, cleaning
+   and re-importing all dependencies may be necessary:
+
+   ```bash
+   rm -rf src/*
+   vcs import src < autoware.repos
+   ```
+
 3. Install dependent ROS packages.
 
    ```bash
    source /opt/ros/humble/setup.bash
+   # Make sure all previously installed ros-$ROS_DISTRO-* packages are upgraded to their latest version
+   sudo apt update && sudo apt upgrade
+   rosdep update
    rosdep install -y --from-paths src --ignore-src --rosdistro $ROS_DISTRO
    ```