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

[mojomex]

Description

Added missing instructions to the following guides:

• Docker update
• Source install
• Source update

Specifically, sudo apt update && sudo apt upgrade were missing: rosdep update and rosdep install will not upgrade previously installed ros-$ROS_DISTRO-* packages (even when Autoware is expected to be built with newer versions), which often results in unexpected Autoware build failures.
From my experience in the last two weeks, following the instructions perfectly on a clean Autoware repo succeeded one out of five times mainly due to this issue.

I also added comments that for moved/removed dependencies in the repos files, vcstool will not sync correctly and result in duplicate or wrongly remaining packages, in which case the src directory has to be deleted and re-pulled.

Pre-review checklist for the PR author

The PR author must check the checkboxes below when creating the PR.

• I've confirmed the contribution guidelines.
• The PR follows the pull request guidelines.

In-review checklist for the PR reviewers

The Reviewers must check the checkboxes below before approval.

• The PR follows the pull request guidelines.

Post-review checklist for the PR author

The PR author must check the checkboxes below before merging.

• There are no open discussions or they are tracked via tickets.

After all checkboxes are checked, anyone who has write access can merge the PR.

[xmfcx]

This workflow works on pull_request_target: so it can't be tested like this :(

I will just go ahead and merge the other PR.

[github-actions]

Documentation URL: https://autowarefoundation.github.io/autoware-documentation/pr-615/
Modified URLs:

• https://autowarefoundation.github.io/autoware-documentation/pr-615/installation/autoware/docker-installation/
• https://autowarefoundation.github.io/autoware-documentation/pr-615/installation/autoware/source-installation/

[xmfcx]

Thanks @mojomex for improving the documentation!

Fixed the deploy-docs workflow and added 2 comments to the PR.

[mojomex]

@xmfcx Thanks for the suggestions, I've addressed them in 6ff3cf5 🙌

[xmfcx]

Thanks!