Merge branch 'development' of https://github.com/intelkevinputnam/clear-linux-documentation into development

source/_themes/otc_tcs_sphinx_theme/static/tcs_theme.css

@@ -492,6 +492,7 @@ div.linenodiv:before { /*add extra new line to make sure code and line numbers a
   margin: 10px;
   border: 10px;
   background: white;
+  position: relative;
 }
 
 .column.featurecard {
@@ -499,11 +500,29 @@ div.linenodiv:before { /*add extra new line to make sure code and line numbers a
   width: 300px;
 }
 
+.column.squarecard {
+  height: 320px;
+}
+
+.column.smallcard {
+  height: 150px;
+}
+
+.endlink {
+  position: absolute;
+  bottom: 10px;
+  right: 10px;
+}
+
 .column.verticalcard {
   height: 615px;
   overflow: auto;
 }
 
+.multicolumns.three {
+  max-width: 1200px;
+}
+
 /* Clear floats after the columns */
 .multicolumns:after {
   content: "";
@@ -550,4 +569,4 @@ div.figure.dropshadow img {
   box-shadow: 10px 10px 10px LightGray;
 }
 
-/*end figure drop shadow*/
+/*end figure drop shadow*/

source/get-started/cloud-install/digitalocean.rst

@@ -147,6 +147,8 @@ Upload image
 
    See Figure 1.
 
+   .. rst-class:: dropshadow
+
    .. figure:: ../../_figures/digitalocean/01-digitalocean.png
       :scale: 100 %
       :alt: DigitalOcean - Upload custom images

source/guides/clear/index.rst

@@ -0,0 +1,79 @@
+.. _cl-guides:
+
+|CL-ATTR|
+#########
+
+.. note::
+
+   As of 22 May 2019 :file:`mixin` is no longer supported.
+
+.. container:: multicolumns three
+
+   .. container:: column smallcard featurecard
+
+      :ref:`swupd-guide`
+         Learn how to manage software and system updates in |CL|.
+
+   .. container:: column smallcard featurecard
+
+      :ref:`debug`
+         Discover how to use :command:`clr-debug-info` to leverage your
+         network to debug system software.
+
+   .. container:: column smallcard featurecard
+
+      :ref:`telem-guide`
+         Learn how you can opt-in to allow |CL| to collect data to identify
+         and fix bugs.
+
+   .. container:: column smallcard
+      
+      :ref:`autoproxy`
+          Discover how |CL| makes working behind a corporate proxy smoother.
+
+   .. container:: column smallcard
+
+      :ref:`autospec`
+         Learn about :command:`autospec` and how it used to automatically
+         include and maintain open source software in |CL|.
+
+   .. container:: column smallcard
+
+      :ref:`bundles-guide`
+         Find out what a bundle is and why it is an important part of
+         what makes |CL| secure and high performance. 
+
+   .. container:: column smallcard
+
+      :ref:`compatible-kernels`
+         Learn about all of the kernels available as installable bundles.
+
+   .. container:: column smallcard
+
+      :ref:`ister`  
+         Find out how |CL| uses this template-based installer to produce
+         images for each release.
+
+   .. container:: column smallcard
+
+      :ref:`mixer`
+         Learn how the |CL| team generates official update content and
+         releases.
+
+   .. container:: column smallcard
+
+      :ref:`security`
+         Learn how |CL| is designed to ensure the security of updates and
+         software.
+
+   .. container:: column smallcard
+
+      :ref:`stateless`
+         |CL| is stateless is designed to need little to no user
+         configuration.
+
+.. toctree::
+   :glob:
+   :hidden:
+
+   *

source/guides/index.rst

@@ -3,55 +3,75 @@
 Guides
 ######
 
-The following guides provide step-by-step instructions on using |CL|.
+.. rst-class:: colh2
 
-.. note::
+Featured Guides
 
-   As of 22 May 2019 :file:`mixin` is no longer supported.
+.. container:: multicolumns three
 
-.. _cl-guides:
+   .. container:: column smallcard
+      
+      :ref:`stateless`
+         |CL| is stateless is designed to need little to no user
+         configuration. 
 
-Clear Linux
-===========
+   .. container:: column smallcard
+
+      :ref:`mixer`
+          Learn how the |CL| team generates official update content and
+          releases.
+
+   .. container:: column smallcard
+
+      :ref:`dars`
+         Learn how to use the :abbr:`DARS (Data Analytics Reference Stack)`,
+         and build your own DARS container image.
+
+   .. container:: column smallcard
+
+      :ref:`dbrs`
+         Learn about the hardware and installation requirements of
+         :abbr:`DBRS (Database Reference Stack)`, and how to use |CL|
+         to host it.
+
+   .. container:: column smallcard
+
+      :ref:`cpu-performance`
+         Learn how to modify CPU power and performance settings for your
+         usecase. 
+
+   .. container:: column smallcard
+
+      :ref:`developer-workstation`
+         Set your workstation up with all bundles needed to
+         start your |CL| development project.
+
+   .. container:: column smallcard
+
+      :ref:`vnc`
+         Learn how to use VNC to connect to a remote |CL| host.
+
+   .. container:: column smallcard
+
+      :ref:`openssh-server`
+         Learn how to set up the SSH service.
+
+   .. container:: column smallcard
+
+      :ref:`kernel-modules`
+         Learn how to correctly and reliably add kernel modules manually.
+
+   .. container:: column smallcard
+
+     :ref:`kernel-development`
+         Learn how to compile a Linux\* kernel from source using |CL|
+         development tooling.
 
 .. toctree::
-   :maxdepth: 1
-   :glob:
+   :hidden:
 
-   clear/*
-
-Maintenance
-===========
-
-.. toctree::
-   :maxdepth: 1
-   :glob:
-
-   maintenance/*
-
-Network
-=======
-
-.. toctree::
-   :maxdepth: 1
-   :glob:
-
-   network/*
-
-Kernel
-=======
-
-.. toctree::
-   :maxdepth: 1
-   :glob:
-
-   kernel/*
-
-Stacks
-=======
-
-.. toctree::
-   :maxdepth: 1
-   :glob:
-
-   stacks/*
+   clear/index
+   maintenance/index
+   network/index
+   kernel/index
+   stacks/index

source/guides/kernel/index.rst

@@ -0,0 +1,9 @@
+.. _kernel-guides:
+
+Kernel
+######
+
+.. toctree::
+   :glob:
+
+   *

source/guides/maintenance/index.rst

@@ -0,0 +1,9 @@
+.. _maintain-guides:
+
+Maintenance
+###########
+
+.. toctree::
+   :glob:
+
+   *

source/guides/network/index.rst

@@ -0,0 +1,9 @@
+.. _network-guides:
+
+Network
+#######
+
+.. toctree::
+   :glob:
+
+   *

source/guides/stacks/index.rst

@@ -0,0 +1,9 @@
+.. _stacks-guides:
+
+Stacks
+######
+
+.. toctree::
+   :glob:
+
+   *

source/index.rst

@@ -75,4 +75,4 @@
    tutorials/index
    reference/index
    FAQ/index
-   collaboration/collaboration
+   collaboration/collaboration