Update theme (#142)

Update theme
---------

Signed-off-by: Mike McKiernan <mmckiernan@nvidia.com>

Author: mikemckiernan

.codespell_exclude_lines.txt

@@ -18,3 +18,31 @@ command-line argument to the ``az aks nodepool add`` command.
 `Skip GPU driver installation (preview) <https://learn.microsoft.com/en-us/azure/aks/gpu-cluster?source=recommendations&tabs=add-ubuntu-gpu-node-pool#skip-gpu-driver-installation-preview>`__
 After you start your Azure AKS cluster with an image that includes a preinstalled NVIDIA GPU Driver
    Azure AKS <microsoft-aks.rst>
+.. |prod-name-short| replace:: MKE
+Mirantis Kubernetes Engine (MKE) gives you the power to build, run, and scale cloud-native
+   * - MKE 3.6.2+ and 3.5.7+
+* A running MKE cluster with at least one control plane node and two worker nodes.
+* A seed node to connect to the MKE instance, with Helm 3.x installed on the seed node.
+* The kubeconfig file for the MKE cluster on the seed node.
+  You can get the file from the MKE web interface by downloading a client bundle.
+  Alternatively, if the MKE cluster is a managed cluster of a Mirantis Container Cloud (MCC) instance,
+  In this case, the MKE web interface can be accessed from the MCC web interface.
+* You have an MKE administrator user name and password, and you have the MKE host URL.
+Perform the following steps to prepare the MKE cluster:
+#. MKE does not apply a label to worker nodes.
+      $ export MKE_USERNAME=<mke-username> \
+          MKE_PASSWORD=<mke-password> \
+          MKE_HOST=<mke-fqdn-or-ip-address>
+#. Get an API key from MKE so that you can make API calls later:
+          '{"username":"'$MKE_USERNAME'","password":"'$MKE_PASSWORD'"}' \
+          https://$MKE_HOST/auth/login | jq --raw-output .auth_token)
+#. Download the MKE configuration file:
+      $ curl --silent --insecure -X GET "https://$MKE_HOST/api/ucp/config-toml" \
+#. Upload the edited MKE configuration file:
+          https://$MKE_HOST/api/ucp/config-toml
+The MKE cluster is ready for you to install the GPU Operator with Helm.
+Refer to the MKE product documentation for information about working with MKE.
+* https://docs.mirantis.com/mke/3.6/overview.html
+         $ cat <<EOF > nvidia-container-microshift.te
+         $ checkmodule -m -M -o nvidia-container-microshift.mod nvidia-container-microshift.te
+      2023/06/22 14:25:38 Retreiving plugins.

.gitlab-ci.yml

@@ -2,7 +2,7 @@ variables:
   CONTAINER_TEST_IMAGE: "${CI_REGISTRY_IMAGE}:${CI_COMMIT_REF_SLUG}"
   CONTAINER_RELEASE_IMAGE: "${CI_REGISTRY_IMAGE}:0.5.0"
   BUILDER_IMAGE: ghcr.io/nvidia/cloud-native-docs:0.2.0
-  PUBLISHER_IMAGE: "${CI_REGISTRY_PUBLISHER}/publisher:2.0.0"
+  PUBLISHER_IMAGE: "${CI_REGISTRY_PUBLISHER}/publisher:3.1.0"
 
 stages:
 - .pre

README.md

@@ -108,25 +108,24 @@ Always update the openshift docset when there is a new gpu-operator docset versi
     copyright_start = 2020
    ```
 
-1. Update the version in `<component-name>/versions.json`:
+1. Update the version in `<component-name>/versions1.json`:
 
    ```diff
-   diff --git a/container-toolkit/versions.json b/container-toolkit/versions.json
-   index 334338a..b15af73 100644
-   --- a/container-toolkit/versions.json
-   +++ b/container-toolkit/versions.json
-   @@ -1,7 +1,10 @@
-    {
-   -    "latest": "1.13.1",
-   +    "latest": "NEW_VERSION",
-     "versions":
-        [
-   +        {
-   +            "version": "NEW_VERSION"
-   +        },
-            {
-                "version": "1.13.1"
-            },
+   diff --git a/container-toolkit/versions1.json b/container-toolkit/versions1.json
+   index 95429953..e2738987 100644
+   --- a/container-toolkit/versions1.json
+   +++ b/container-toolkit/versions1.json
+   @@ -1,6 +1,10 @@
+    [
+      {
+        "preferred": "true",
+   +    "url": "../1.17.4",
+   +    "version": "1.17.4"
+   +  },
+   +  {
+        "url": "../1.17.3",
+        "version": "1.17.3"
+      },
    ```
 
    These values control the menu at the bottom of the table of contents and
@@ -137,13 +136,13 @@ Always update the openshift docset when there is a new gpu-operator docset versi
    The documentation for the older releases is not removed, readers are just
    less likely to browse the older releases.
 
-### Tagging and Special Branch Naming
+### Tagging for Publication
 
 Changes to the default branch are not published on docs.nvidia.com.
 
-Only tags or specially-named branches are published to docs.nvidia.com.
+Only tags are published to docs.nvidia.com.
 
-1. Create a tag or specially-named branch from your commit with the following naming pattern: `<component-name>-v<version>`.
+1. Create a tag from your commit with the following naming pattern: `<component-name>-v<version>`.
 
    *Example*
 
@@ -152,13 +151,13 @@ Only tags or specially-named branches are published to docs.nvidia.com.
    ```
 
    The first three fields of the semantic version are used.
-   For a "do over," push a tag like `gpu-operator-v23.3.1.1`.
+   For a "do over," push a tag like `gpu-operator-v23.3.1-1`.
 
-   Always tag the openshift docset and driver-containers docset for each new gpu-operator docset release.
+   Always tag the openshift docset and for each new gpu-operator docset release.
 
-1. Push the tag or specially-named branch to the repository.
+1. Push the tag to the repository.
 
-CI builds the documentation for the Git ref---currently for all software components.
+CI builds the documentation for the Git ref, for all software components.
 However, only the documentation for the `component-name` and specified version is updated on the web.
 By default, the documentation for the "latest" URL is updated.
 

container-toolkit/cdi-support.md

@@ -8,14 +8,6 @@
 
 # Support for Container Device Interface
 
-```{contents}
----
-depth: 2
-local: true
-backlinks: none
----
-```
-
 ## About the Container Device Interface
 
 As of the `v1.12.0` release the NVIDIA Container Toolkit includes support for generating Container Device Interface (CDI) specifications.

container-toolkit/docker-specialized.md

@@ -4,14 +4,6 @@
 
 # Specialized Configurations with Docker
 
-```{contents}
----
-depth: 2
-local: true
-backlinks: none
----
-```
-
 ## Environment variables (OCI spec)
 
 Users can control the behavior of the NVIDIA container runtime using environment variables - especially for

container-toolkit/install-guide.md

@@ -4,14 +4,6 @@
 
 # Installing the NVIDIA Container Toolkit
 
-```{contents}
----
-depth: 2
-local: true
-backlinks: none
----
-```
-
 ## Installation
 
 (pre-requisites)=

container-toolkit/sample-workload.md

@@ -1,13 +1,5 @@
 # Running a Sample Workload
 
-```{contents}
----
-depth: 2
-local: true
-backlinks: none
----
-```
-
 ## Running a Sample Workload with Docker
 
 After you install and configure the toolkit and install an NVIDIA GPU Driver,

container-toolkit/supported-platforms.md

@@ -6,13 +6,6 @@
 
 # Supported Platforms
 
-```{contents}
----
-depth: 2
-local: true
-backlinks: none
----
-```
 
 ## Linux Distributions
 

container-toolkit/troubleshooting.md

@@ -6,14 +6,6 @@
 
 # Troubleshooting
 
-```{contents}
----
-depth: 2
-local: true
-backlinks: none
----
-```
-
 ## Troubleshooting with Docker
 
 ### Generating Debugging Logs
@@ -67,7 +59,7 @@ The conflicting repository references can be obtained by running and inspecting
 $ grep "nvidia.github.io" /etc/apt/sources.list.d/*
 ```
 
-The list of files with (possibly)  conflicting references can be optained by running:
+The list of files with possibly conflicting references can be obtained by running:
 
 ```console
 $ grep -l "nvidia.github.io" /etc/apt/sources.list.d/* | grep -vE "/nvidia-container-toolkit.list\$"
@@ -105,7 +97,7 @@ allow this access for now by executing:
 
 This occurs because `nvidia-docker` forwards the command line arguments with minor modifications to the `docker` executable.
 
-To address this it is recommeded that the `docker` command be used directly specifying the `nvidia` runtime:
+To address this, specify the NVIDIA runtime in the the `docker` command:
 
 ```console
 $ sudo docker run --gpus=all --runtime=nvidia --rm nvcr.io/nvidia/cuda:11.6.2-base-ubuntu20.04 nvidia-smi

container-toolkit/versions.json

@@ -25,6 +25,6 @@
         },
         {
             "version": "1.16.0"
-        },
+        }
     ]
 }