Merge pull request #705 from krisdale/kd-minor-migration-text-revisions

Minor revisions as part of transition to new location

source/about.rst

@@ -19,8 +19,8 @@ For detailed information on these topics, refer to the :ref:`cl-guides` guides.
 Release Cadence
 ***************
 
-|CL| updates are based on a rolling release that can occur daily but usually
-occurs a few times per week. Each release has a unique version number that
+|CL| updates are based on a rolling release that can occur daily, up to a few
+times per week. Each release has a unique version number that
 identifies every component in the OS from kernel, to driver, to tool, to GUI
 application. Most components are included in entities called *bundles*.
 
@@ -46,8 +46,7 @@ Ease of Use
 * Being :ref:`stateless` means that configuration settings are easier to manage
   and remain untouched when system sofware is updated.
 
-* :ref:`swupd-guide` also makes it easy to manage software and maintain
-  compatibility.
+* :ref:`swupd-guide` simplifies managing software and maintaining compatibility.
 
 Custom Derivatives
 ******************

source/conf.py

@@ -147,7 +147,7 @@ html_context = {
                    #("Chinese", "/clearlinux/latest/zh_CN")
                  ),
     "versions": ( ("latest", "/clearlinux/latest"),
-                  ("Future LTS Support", "/clearlinux/latest"))
+                  ("Future versions", "/clearlinux/latest"))
                   #("L19.01", "/clearlinux/L19.01"))
 }
 

source/get-started/bootable-usb.rst

@@ -129,7 +129,7 @@ Burn the |CL| image onto a USB drive
 
    This will list available disks and their partitions, as shown in Figure 1.
 
-   .. figure:: figures/bootable-usb-mac-01.png
+   .. figure:: /_figures/bootable-usb/bootable-usb-mac-01.png
       :scale: 100 %
       :alt: Get USB drive identifier
 
@@ -187,7 +187,7 @@ Burn the |CL| image onto a USB drive
 
 #. Click the :guilabel:`START` button. See Figure 2.
 
-   .. figure:: figures/bootable-usb-windows-02.png
+   .. figure:: /_figures/bootable-usb/bootable-usb-windows-02.png
       :scale: 80 %
       :alt: Rufus utility
 
@@ -196,7 +196,7 @@ Burn the |CL| image onto a USB drive
 #. When the dialogue appears, select
    :guilabel:`Write in ISO image mode (Recommended)`. See Figure 3.
 
-   .. figure:: figures/bootable-usb-windows-03.png
+   .. figure:: /_figures/bootable-usb/bootable-usb-windows-03.png
       :scale: 80 %
       :alt: ISOHybrid image detected
 

source/get-started/index.rst

@@ -24,7 +24,7 @@ When installing |CL-ATTR| in a VM, consider which kernel to use.
    :hidden:
 
    compatibility-check
-   bootable-usb/bootable-usb
+   bootable-usb
 
 Install
 *******

source/index.rst

@@ -10,33 +10,41 @@ Our documentation is divided into the following sections:
 
 :ref:`get-started`
 
-    If you are new to |CL|, get started quickly with step-by-step instructions for installing |CL| on bare metal, in a virtual environment, or as a live image on a USB stick.
+    If you are new to |CL|, get started quickly with step-by-step instructions
+    for installing |CL| on bare metal, in a virtual environment, or as a live
+    image on a USB stick.
 
 :ref:`about`
 
     |CL| is different from other Linux distributions.
 
-    Updates, ease of use, and custom derivatives are a few of the differences this section explains. Orient yourself to these differences and why they matter to you.
+    Updates, ease of use, and custom derivatives are a few of the differences
+    this section explains. Orient yourself to these differences and why they
+    matter to you.
+
+    .. raw:: html
+
+       <iframe width="560" height="315" src="https://www.youtube.com/embed/JFg-_5xihkE" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen style="padding:10px; background-color: #fff;"></iframe>
 
 :ref:`guides`
 
-    Guides cover a range of topics from |CL| features and tooling, to system maintenance, network, and stacks.
+    Guides cover a range of topics from |CL| features and tooling, to system
+    maintenance, network, and stacks.
 
 :ref:`Use case tutorials <tutorials>`
 
-    Sample use cases, with step-by-step instructions, show how to set up third-party tools and software with |CL|.
+    Sample use cases, with step-by-step instructions, show how to set up
+    third-party tools and software with |CL|.
 
 :ref:`reference`
 
-    The reference section contains supplemental information in support of |CL| configuration, system requirements, and contributions.
+    This section provides additional reference information on the |CL| project.
 
 :ref:`faq`
 
     The FAQ section provides answers to commonly asked questions about |CL|.
 
-.. raw:: html
 
-   <iframe width="560" height="315" src="https://www.youtube.com/embed/JFg-_5xihkE" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen style="padding:10px; background-color: #fff;"></iframe>
 
 .. toctree::
     :maxdepth: 2