diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst index 476383b6..cccd19a3 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-linux.rst @@ -37,7 +37,7 @@ Burn the Clear Linux image onto a USB drive #. Go to the directory with the uncompressed image. #. Plug in the USB drive. -#. Identify the USB drive using the `lsblk` command. This shows all drives +#. Identify the USB drive using the :command:`lsblk` command. This shows all drives attached to the system, including the primary hard disk. In the example output below, there are 4 drives (`/dev/sda`, `/dev/sdb`, `/dev/sdc`, and `/dev/sdd`) attached, where `/dev/sda` is primary drive in this case. The @@ -73,8 +73,8 @@ Burn the Clear Linux image onto a USB drive #. Before an image can be burned onto a USB drive, it should be un-mounted. Some Linux distros may automatically mount a USB drive when it is plugged - in. To unmount, use the `umount` command followed by the device - identifier/partition. For example: From the above `lsblk` output, + in. To unmount, use the :command:`umount` command followed by the device + identifier/partition. For example: From the above :command:`lsblk` output, `/dev/sdd` has 2 mounted partitions. To unmount them, enter: .. code-block:: console diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst index 08dee52c..e11803ae 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-mac.rst @@ -31,7 +31,7 @@ Burn the Clear Linux image onto a USB drive #. Launch the Terminal app. #. Go to the directory with the uncompressed image. #. Plug in a USB drive and get its identifier by entering the command - `diskutil list`. See Figure 1. + :command:`diskutil list`. See Figure 1. .. code-block:: console @@ -41,6 +41,8 @@ Burn the Clear Linux image onto a USB drive :scale: 100 % :alt: Get USB drive identifier + Figure 1: macOS - Get USB drive identifier + #. Unmount the USB drive identified in the previous step. The command-line example below umounts `/dev/disk2`: @@ -48,18 +50,18 @@ Burn the Clear Linux image onto a USB drive $ diskutil umountDisk /dev/disk2 -#. Burn the image onto the drive. The command-line example below burns an - uncompressed image onto `/dev/disk2`: +#. Burn the image onto the drive using the :command:`dd` command. The + command-line example below burns an uncompressed image onto `/dev/disk2`: .. code-block:: console $ sudo dd if=./clear-[version number]-[image type] of=/dev/rdisk2 bs=4m - .. note:: - * Adding an ‘r’ in front of the disk identifier should help speed up the - imaging process. - * Press :kbd:`-T` to check imaging progress. + Adding an ‘r’ in front of the disk identifier should help speed up the + imaging process. + + You can press :kbd:`-T` to check imaging progress. #. Eject the USB drive. diff --git a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst index 1938ea0b..33954919 100644 --- a/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst +++ b/source/clear-linux/get-started/bootable-usb/bootable-usb-windows.rst @@ -27,15 +27,34 @@ Burn the Clear Linux image onto a USB drive |CAUTION-BACKUP-USB| -#. Download the `Rufus`_ tool to burn the image onto a USB drive. -#. Plug in the USB drive. -#. Click the CD-ROM icon button and select the |CL| image file. See Figure 1. -#. Ensure that :guilabel:`Create a bootable disk using DD - Image` is checked. +#. Download the `Rufus`_ tool to burn the image onto a USB drive. +#. Plug in the USB drive. +#. Click the :guilabel:`CD-ROM` icon button. See Figure 1. - .. figure:: figures/bootable-usb-windows-1.png - :scale: 100 % - :alt: Burn image onto USB drive + .. figure:: figures/bootable-usb-windows-1.png + :scale: 80 % + :alt: Rufus utility - Click CD-ROM button + + Figure 1: Rufus utility - Click CD-ROM button + +#. By default, Rufus only shows ISO files. To find and select a compressed |CL| + image file, you must click the file-type dropdown and select :guilabel:`All files`. + See Figure 2. + + .. figure:: figures/bootable-usb-windows-2.png + :scale: 80 % + :alt: Rufus utility - Show and select |CL| image file + + Figure 2: Rufus utility - Show and select |CL| image file + +#. Verify that :guilabel:`Create a bootable disk using DD Image` checkbox is + checked. See Figure 3. + + .. figure:: figures/bootable-usb-windows-3.png + :scale: 80 % + :alt: Rufus utility - Create a bootable disk using DD Image + + Figure 3: Rufus utility - Create a bootable disk using DD Image #. Click :guilabel:`Start`. diff --git a/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-1.png b/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-1.png index 5798a012..39152060 100644 Binary files a/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-1.png and b/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-1.png differ diff --git a/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-2.png b/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-2.png new file mode 100644 index 00000000..2441ff67 Binary files /dev/null and b/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-2.png differ diff --git a/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-3.png b/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-3.png new file mode 100644 index 00000000..f9e32fe3 Binary files /dev/null and b/source/clear-linux/get-started/bootable-usb/figures/bootable-usb-windows-3.png differ diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst index fb817890..8cd944c7 100644 --- a/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-linux.rst @@ -19,11 +19,10 @@ We also provide instructions for other operating systems: Verify the integrity of the Clear Linux image ********************************************* -Before you use a downloaded |CL| image, it is recommended that you verify its -integrity to eliminate the chance, albeit small, that it might be corrupted -due to any download issues. To support this, each released |CL| image is -accompanied by an official SHA512 checksum file, which is designated with the -suffix `-SHA512SUMS`. +Before you use a downloaded |CL| image, verify its integrity. Thus, you +eliminate the small chance of a corrupted image due to download issues. +To support verification, we accompany each released |CL| image with an official +SHA512 checksum file, which is designated with the suffix `-SHA512SUMS`. #. Download the official corresponding SHA512 checksum file of your downloaded |CL| image. @@ -43,10 +42,9 @@ a match and your downloaded image is good. Uncompress the Clear Linux image ******************************** -All released |CL| images are compressed by default using either GNU zip -(`.gz`) or XZ (`.xz`). The compression typed used is dependent on which -platform/enviroment the image is targeted for. Uncompress your image using -these steps: +We compress all released |CL| images by default with either GNU zip +(`.gz`) or XZ (`.xz`). The compression type we use depends on the target +platform or environment of the image. To uncompress the image, follow these steps: #. Start a terminal emulator. #. Go to the directory with the downloaded image. diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-mac.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-mac.rst index 3ffe39eb..3c3eb766 100644 --- a/source/clear-linux/guides/maintenance/download-verify-uncompress-mac.rst +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-mac.rst @@ -19,11 +19,10 @@ We also provide instructions for other operating systems: Verify the integrity of the Clear Linux image ********************************************* -Before you use a downloaded |CL| image, it is recommended that you verify its -integrity to eliminate the chance, albeit small, that it might be corrupted -due to any download issues. To support this, each released |CL| image is -accompanied by an official SHA512 checksum file, which is designated with the -suffix `-SHA512SUMS`. +Before you use a downloaded |CL| image, verify its integrity. Thus, you +eliminate the small chance of a corrupted image due to download issues. +To support verification, we accompany each released |CL| image with an official +SHA512 checksum file, which is designated with the suffix `-SHA512SUMS`. #. Download the official corresponding SHA512 checksum file of your downloaded |CL| image. @@ -43,10 +42,9 @@ a match and your downloaded image is good. Uncompress the Clear Linux image ******************************** -All released |CL| images are compressed by default using either GNU zip -(`.gz`) or XZ (`.xz`). The compression typed used is dependent on which -platform/enviroment the image is targeted for. Uncompress your image using -these steps: +We compress all released |CL| images by default with either GNU zip +(`.gz`) or XZ (`.xz`). The compression type we use depends on the target +platform or environment of the image. To uncompress the image, follow these steps: #. Start the Terminal app. #. Go to the directory with the downloaded image. diff --git a/source/clear-linux/guides/maintenance/download-verify-uncompress-windows.rst b/source/clear-linux/guides/maintenance/download-verify-uncompress-windows.rst index 31e63330..e222d6b2 100644 --- a/source/clear-linux/guides/maintenance/download-verify-uncompress-windows.rst +++ b/source/clear-linux/guides/maintenance/download-verify-uncompress-windows.rst @@ -19,11 +19,10 @@ We also provide instructions for other operating systems: Verify the integrity of the Clear Linux image ********************************************* -Before you use a downloaded |CL| image, it is recommended that you verify its -integrity to eliminate the chance, albeit small, that it might be corrupted -due to any download issues. To support this, each released |CL| image is -accompanied by an official SHA512 checksum file, which is designated with the -suffix `-SHA512SUMS`. +Before you use a downloaded |CL| image, verify its integrity. Thus, you +eliminate the small chance of a corrupted image due to download issues. +To support verification, we accompany each released |CL| image with an official +SHA512 checksum file, which is designated with the suffix `-SHA512SUMS`. #. Download the official corresponding SHA512 checksum file of your downloaded |CL| image. @@ -41,10 +40,9 @@ suffix `-SHA512SUMS`. Uncompress the Clear Linux image ******************************** -All released |CL| images are compressed by default using either GNU zip -(`.gz`) or XZ (`.xz`). The compression typed used is dependent on which -platform/enviroment the image is targeted for. Uncompress your image using -these steps: +We compress all released |CL| images by default with either GNU zip +(`.gz`) or XZ (`.xz`). The compression type we use depends on the target +platform or environment of the image. To uncompress the image, follow these steps: #. Download and install `7zip`_. #. Locate the |CL| image and right-click it.