Add Jazzy documentation

[civerachb-cpr]

Description

• Add jazzy tabs where relevant
• Add deprecation notices to all Galactic pages & tabs indicating that it is no longer supported

[hilary-luo]

Overall the changes look good but there seems to be some sections that need Jazzy specific attention.

[hilary-luo]

Has this file changed in anyway that would affect it's usability in Humble?

[civerachb-cpr]

The Jazzy version adds

for device in $device_names
do
    if [[ $device == mmcblk* ]]; then
        last_partition="${device}p2"
    else
        last_partition="${device}2"
    fi

    sudo growpart /dev/$device 2
    sudo resize2fs /dev/${last_partition}
done

to the end of the script to automatically expand the writable partition to the maximum space of the SD card. I haven't tested the Jazzy script with Humble images, so I'm not sure if the change is backwards-compatible. But using the Jazzy version of the script with the Jazzy images is recommended.

[hilary-luo]

This file needs to be updated for the usage of the republisher. (Ensuring that the create3 is disconnected from WiFi and linking to the description of the republisher - like in discovery server.)

[civerachb-cpr]

Took a first pass at the rewrites. I moved the wifi & application config into new tabs and added a new screenshot for Jazzy.

[hilary-luo]

Can we clarify (for both Jazzy and Humble) that the _do_not_use namespace should not be used anywhere outside of the create3 webserver. The only place where that namespace needs to be used directly is when setting the "Application ROS 2 Parameters File" within the create3 webserver.

[civerachb-cpr]

Added a note to Humble and Jazzy about this.

[hilary-luo]

The debug file overrides the _config.yml so if we want debug to perform the same as the release then we should remove both lines (remote_theme and theme) rather than duplicating what is present in the _config.yml file.

[civerachb-cpr]

Done

[hilary-luo]

This is unnecessary because it is run as part of the make command.

[civerachb-cpr]

Done

[hilary-luo]

Can we add the update command into this process so it looks like:

make
make update
make server

This will ensure that the dependencies get updated, aligning with how the actual release will get built. (Otherwise the versions that you use locally stay locked to when you first built.) It is a future discussion to be had, (or you can look into) whether we can include the Gemfile.lock in the repo and whether that will be respected by Github Pages when it gets built, and not have to deal with the constant dependency updates.

[civerachb-cpr]

Done

[hilary-luo]

This needs to update for the Create3 no longer needing to be connected to wifi and should contain a brief description that the create3 info is routed through the pi. Additionally the 2.4 GHz network is no longer required at all and does not need to be bridged.

[civerachb-cpr]

Done

[hilary-luo]

The trailing spaces in this section are functional. When it gets built, the single newline is removed and no additional space is added. Can we either leave the trailing space or remove the unnecessary newlines. I have only made this comment here but there are a number of pages with this same issue. (Including this file, discovery_server.md, simple_discovery.md, diagnostics.md, multiple_robots.md). This only affects paragraphs that are interrupted by single newlines (double newline indicating the start of a new paragraph).

[civerachb-cpr]

Do we want to force newlines like that though? For adaptive screen sizes or users with accessibility issues (e.g. larger-than-default fonts) it seems better to just let the default line-wrapping do its thing, rather than manually inserting line breaks that may not always align correctly.

[civerachb-cpr]

Some of the trailing spaces removed were already at the ends of paragraphs or were independent list items, so I've left those alone. The rest I've removed the superfluous line breaks from the source.