Update landing pages and tooling (14) (#1645)

* update home page

* add missing heading

* update starter pack version to 1.6

* update how-to landing page

* update reference landing page

* update explanation landing page

* fix spelling errors

* Update docs/reference/index.md

Co-authored-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>
Signed-off-by: Andreia <andreia.velasco@canonical.com>

* fix copyright and license information

---------

Signed-off-by: Andreia <andreia.velasco@canonical.com>
Co-authored-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

Author: a-velasco

.readthedocs.yaml

@@ -18,7 +18,7 @@ build:
     # This is a special exit code on Read the Docs that will cancel the build immediately.
     # https://docs.readthedocs.io/en/stable/build-customization.html#cancel-build-based-on-a-condition
     - |
-      if [ "$READTHEDOCS_VERSION_TYPE" = "external" ] && git diff --quiet origin/14/docs -- 'docs/' '.readthedocs.yaml';
+      if [ "$READTHEDOCS_VERSION_TYPE" = "external" ] && git diff --quiet origin/main -- 'docs/' '.readthedocs.yaml';
       then
         exit 183;
       fi
@@ -30,8 +30,8 @@ sphinx:
   fail_on_warning: true
 
 # If using Sphinx, optionally build your docs in additional formats such as PDF
-# formats:
-# - pdf
+formats:
+- pdf
 
 # Optionally declare the Python requirements required to build your docs
 python:

docs/.gitignore

@@ -1,6 +1,6 @@
 # Environment
 *env*/
-.sphinx/venv/
+.venv/
 
 # Sphinx
 .sphinx/warnings.txt

docs/.sphinx/.pymarkdown.json

@@ -0,0 +1,46 @@
+{
+    "plugins": {
+        "selectively_enable_rules": true,
+        "heading-style": {
+            "enabled": true,
+            "style": "atx"
+        },
+        "commands-show-output": {
+            "enabled": true
+        },
+        "no-missing-space-atx": {
+            "enabled": true
+        },
+        "blanks-around-headings": {
+            "enabled": true
+        },
+        "heading-start-left": {
+            "enabled": true
+        },
+        "no-trailing-punctuation": {
+            "enabled": true,
+            "punctuation": ".,;。，；"
+        },
+        "blanks-around-fences": {
+            "enabled": true,
+            "list_items": false
+        },
+        "blanks-around-lists": {
+            "enabled": true
+        },
+        "hr-style": {
+            "enabled": true
+        },
+        "no-empty-links": {
+            "enabled": true
+        },
+        "no-alt-text": {
+            "enabled": true
+        }
+    },
+    "extensions": {
+        "front-matter" : {
+            "enabled" : true
+        }
+    }
+}