doc: Replace references to img.gz with img.xz

> (Release) SD card images are now released with xz compression (as .img.xz files) rather than gzip compression (as .img.gz files).

See https://docs.planktoscope.community/reference/software/changelog/#v202400-beta1-2024-06-24

Author: sonnyp

documentation/docs/community/contribute/tips-and-tricks.md

@@ -33,7 +33,7 @@ sudo dd bs=1M if=/dev/device status=progress | xz > sdcard.img.xz
 
 ```sh
 # restore an image file from your computer onto the SD card
-xzcat sdcard.img.xz | sudo dd bs=1M of=/dev/mmcblk0 status=progress
+xzcat sdcard.img.xz | sudo dd bs=1M of=/dev/device status=progress
 ```
 
 See also the operating guide [SD Card Cloning](../../operation/clone-sd.md).

documentation/docs/operation/clone-sd.md

@@ -105,10 +105,10 @@ In order to make the SD card practical to share, you should shrink and compress
 cd /some/path/here
 wget https://raw.githubusercontent.com/Drewsif/PiShrink/master/pishrink.sh
 chmod +x pishrink.sh
-sudo ./pishrink.sh -za image-name-here.img
+sudo ./pishrink.sh -Za image-name-here.img
 ```
 
-If you had set up the PlanktoScope software on a Raspberry Pi OS Lite image, you should get a `image-name-here.img.gz` file which is at least 2 GB in size.
+If you had set up the PlanktoScope software on a Raspberry Pi OS Lite image, you should get a `image-name-here.img.xz` file which is at least 2 GB in size.
 
 ## Use the SD card image
 

documentation/docs/setup/software/index.md

@@ -10,7 +10,7 @@ In order to install the PlanktoScope software, you will first need to choose an
 
 ## Choosing an SD card image
 
-PlanktoScope SD card image files are identified with a version number as well as a hardware configuration tag - for example, the SD card image file named `planktoscope-v2024.0.0+planktoscopehat.img.gz` is for v2020.0.0 of the PlanktoScope OS, configured to work with versions of the PlanktoScope hardware based on the custom PlanktoScope HAT (rather than the Adafruit Stepper Motor HAT). Thus, you will need to choose both a version number (e.g. v2023.9.0) and a hardware configuration (e.g. `planktoscopehat`).
+PlanktoScope SD card image files are identified with a version number as well as a hardware configuration tag - for example, the SD card image file named `planktoscope-v2024.0.0+planktoscopehat.img.xz` is for v2020.0.0 of the PlanktoScope OS, configured to work with versions of the PlanktoScope hardware based on the custom PlanktoScope HAT (rather than the Adafruit Stepper Motor HAT). Thus, you will need to choose both a version number (e.g. v2023.9.0) and a hardware configuration (e.g. `planktoscopehat`).
 
 ### PlanktoScope OS versions
 

documentation/docs/setup/software/nonstandard-install.md

@@ -43,14 +43,14 @@ Next, you will need to write your downloaded Raspberry Pi OS image file to your
 
 To use a graphical application to write the image file to your microSD card, you can install the Raspberry Pi imager. Download the latest version of the [Raspberry Pi Imager](https://www.raspberrypi.com/software/), install it, and start it. Select the Raspberry Pi OS image file (likely a `.img`, `.img.gz`, or `.img.xz` file) you just downloaded, and select the SD card you want to write the Raspberry Pi OS image to. Review your selections and click the appropriate button to begin writing the Raspberry Pi OS image to the SD card. The process should take several minutes.
 
-If you'd instead prefer to write the image file to your microSD card from a command-line tool, you could instead use a tool like `ddrescue` on a Debian-based system, e.g. as follows:
+If you'd instead prefer to write the `.xz.img` image file to your microSD card from a command-line tool, you can use the following command
 
-```
-gunzip planktoscope-v2.3-final.img.gz
-sudo ddrescue planktoscope-v2.3-final.img /dev/mmcblk0 --force
+```sh
+xzcat sdcard.img.xz | sudo dd bs=1M of=/dev/mmcblk0 status=progress
 ```
 
-Warning: be extremely careful when choosing the storage medium and ensure that you are writing the OS image file to the device which actually corresponds to the correct microSD card. Once the image has been written, data previously on the device will be lost and impossible to recover.
+!!! warning
+    Be extremely careful when choosing the storage medium and ensure that you are writing the OS image file to the device which actually corresponds to the correct microSD card. Once the image has been written, data previously on the device will be lost.
 
 ### Configure your Raspberry Pi
 

software/distro/setup/README.md

@@ -25,4 +25,4 @@ chmod +x pishrink.sh
 sudo ./pishrink.sh -za image-name-here.img
 ```
 
-If you had set up the PlanktoScope software on a Raspberry Pi OS Lite image, you should get a `image-name-here.img.gz` file which is approximately 1 GB in size.
+If you had set up the PlanktoScope software on a Raspberry Pi OS Lite image, you should get a `image-name-here.img.xz` file which is approximately 1 GB in size.