Merge pull request #208 from rackerlabs/fix-style

docs: fix code block style

.markdownlint.yml

@@ -35,3 +35,13 @@ MD033: true
 # MD041 - First line in a file should be a top-level heading
 # This requires a top-level heading as the first line in every doc.
 MD041: true
+
+# MD046 - Code blocks should be fenced for mkdocs
+# unless you're using tabs which will require you to disable
+# this check around that block like:
+# <!-- markdownlint-capture -->
+# <!-- markdownlint-disable MD046 -->
+# all your tab stuff here
+# <!-- markdownlint-restore -->
+MD046:
+    style: fenced

docs/kubernetes.md

@@ -12,6 +12,8 @@ UnderStack also uses common kubernetes tools: Helm, Kustomize, and Kubeseal.
 [Helm](https://helm.sh) is a package manager for kubernetes and UnderStack uses a number of
 upstream Helm charts.
 
+<!-- markdownlint-capture -->
+<!-- markdownlint-disable MD046 -->
 !!! example "Installation"
 
     === "Ubuntu"
@@ -23,11 +25,14 @@ upstream Helm charts.
         sudo apt-get update
         sudo apt-get install helm
         ```
+<!-- markdownlint-restore -->
 
 ### Kustomize
 
 [Kustomize](https://kubectl.docs.kubernetes.io/guides/introduction/kustomize/) helps make customizations in kubernetes easier.
 
+<!-- markdownlint-capture -->
+<!-- markdownlint-disable MD046 -->
 !!! example "Installation"
 
     === "Ubuntu"
@@ -36,12 +41,15 @@ upstream Helm charts.
         curl -s "https://raw.githubusercontent.com/kubernetes-sigs/kustomize/master/hack/install_kustomize.sh"  | bash
         sudo mv kustomize /usr/bin
         ```
+<!-- markdownlint-restore -->
 
 ### Kubeseal
 
 [Sealed Secrets](https://github.com/bitnami-labs/sealed-secrets) and the `kubeseal` cli tool make it possible to
 store sescrets in a public repository.
 
+<!-- markdownlint-capture -->
+<!-- markdownlint-disable MD046 -->
 !!! example "Installation"
 
     === "Ubuntu"
@@ -51,3 +59,4 @@ store sescrets in a public repository.
         tar xzf kubeseal-0.26.0-linux-amd64.tar.gz
         sudo mv kubeseal /usr/bin
         ```
+<!-- markdownlint-restore -->

docs/user-guide/openstack-cli.md

@@ -6,6 +6,8 @@ The easiest way to install the OpenStack CLI is to utilize your
 OS packages. But if you want to install it manually you will need
 to already have Python on your system.
 
+<!-- markdownlint-capture -->
+<!-- markdownlint-disable MD046 -->
 === "Ubuntu or Debian"
 
     ``` bash
@@ -43,38 +45,39 @@ to already have Python on your system.
     export PATH="$HOME/.bin:$PATH"
     EOF
     ```
+<!-- markdownlint-restore -->
 
 ## Configuration
 
 The easiest way to configure your client is via `clouds.yaml`.
 
-    ``` yaml title="$HOME/.config/openstack/clouds.yaml"
-    clouds:
-      understack:
-        auth:
-          auth_url: https://your.endpoint.url/v3
-          user_domain_name: mydomain
-          username: myuser
-          password: mypass
-          project_domain_name: mydomain
-          project_name: myproject
-        region_name:
-          - MyRegion
-        interface: public
-        identity_api_version: 3
-    ```
+```yaml title="$HOME/.config/openstack/clouds.yaml"
+clouds:
+  understack:
+    auth:
+      auth_url: https://your.endpoint.url/v3
+      user_domain_name: mydomain
+      username: myuser
+      password: mypass
+      project_domain_name: mydomain
+      project_name: myproject
+    region_name:
+      - MyRegion
+    interface: public
+    identity_api_version: 3
+```
 
 With the above configuration in `$HOME/.config/openstack/clouds.yaml` you
 will be able to run the OpenStack CLI as follows:
 
-    ``` bash
-    openstack --os-cloud understack <sub-command-here>
-    ```
+```bash
+openstack --os-cloud understack <sub-command-here>
+```
 
 Or you can set the `OS_CLOUD` environment variable once and shorten the
 command as follows:
 
-    ``` bash
-    export OS_CLOUD=understack
-    openstack <sub-command-here>
-    ```
+```bash
+export OS_CLOUD=understack
+openstack <sub-command-here>
+```