Merge pull request #2448 from sownak/feature/doc-redesign

[chore] Document redesign first pass

.github/.wordlist.txt

@@ -169,3 +169,5 @@ kube
 PV's
 CorDapp
 storageclass
+gh
+MkDocs

.readthedocs.yaml

@@ -1,35 +1,21 @@
-# Read the Docs configuration file for Sphinx projects
+# Read the Docs configuration file for MkDocs projects
 # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
 
 # Required
 version: 2
 
-# Set the OS, Python version and other tools you might need
+# Set the version of Python and other tools you might need
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.11"
-    # You can also specify other tool versions:
-    # nodejs: "20"
-    # rust: "1.70"
-    # golang: "1.20"
-
-# Build documentation in the "docs/" directory with Sphinx
-sphinx:
-  configuration: docs/source/conf.py
-  # You can configure Sphinx to use a different builder, for instance use the dirhtml builder for simpler URLs
-  # builder: "dirhtml"
-  # Fail on all warnings to avoid broken references
-  # fail_on_warning: true
-
-# Optionally build your docs in additional formats such as PDF and ePub
-# formats:
-#    - pdf
-#    - epub
+    python: "3.12"
+# Build documentation in the "docs/" directory with mkdocs
+mkdocs:
+  configuration: docs/mkdocs.yml
 
 # Optional but recommended, declare the Python requirements required
 # to build your documentation
 # See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
 python:
-   install:
-   - requirements: docs/pip-requirements.txt
+  install:
+  - requirements: docs/pip-requirements.txt