Upgrade docs dependencies

docs/requirements.in

@@ -1,5 +1,5 @@
 markdown-callouts>=0.1.0
-mkdocs>=1.2.1
+mkdocs>=1.5
 mkdocs-code-validator>=0.1.0
 mkdocs-gen-files>=0.3.2
 mkdocs-literate-nav>=0.3.1

docs/requirements.txt

@@ -1,14 +1,16 @@
 #
-# This file is autogenerated by pip-compile with python 3.10
-# To update, run:
+# This file is autogenerated by pip-compile with Python 3.11
+# by the following command:
 #
 #    pip-compile docs/requirements.in
 #
-certifi==2023.5.7
+babel==2.13.1
+    # via mkdocs-material
+certifi==2023.7.22
     # via requests
-charset-normalizer==3.1.0
+charset-normalizer==3.3.2
     # via requests
-click==8.1.3
+click==8.1.7
     # via mkdocs
 colorama==0.4.6
     # via mkdocs-material
@@ -22,7 +24,7 @@ jinja2==3.1.2
     #   mkdocs-material
     #   mkdocstrings
     #   mkdocstrings-crystal
-markdown==3.3.7
+markdown==3.5.1
     # via
     #   markdown-callouts
     #   mkdocs
@@ -35,14 +37,15 @@ markdown-callouts==0.3.0
     # via
     #   -r docs/requirements.in
     #   mkdocstrings-crystal
-markupsafe==2.1.2
+markupsafe==2.1.3
     # via
     #   jinja2
+    #   mkdocs
     #   mkdocstrings
     #   mkdocstrings-crystal
 mergedeep==1.3.4
     # via mkdocs
-mkdocs==1.4.3
+mkdocs==1.5.3
     # via
     #   -r docs/requirements.in
     #   mkdocs-autorefs
@@ -52,54 +55,60 @@ mkdocs==1.4.3
     #   mkdocs-material
     #   mkdocs-section-index
     #   mkdocstrings
-mkdocs-autorefs==0.4.1
+mkdocs-autorefs==0.5.0
     # via
     #   mkdocstrings
     #   mkdocstrings-crystal
-mkdocs-code-validator==0.1.3
+mkdocs-code-validator==0.2.0
     # via -r docs/requirements.in
 mkdocs-gen-files==0.5.0
     # via -r docs/requirements.in
-mkdocs-literate-nav==0.6.0
+mkdocs-literate-nav==0.6.1
     # via -r docs/requirements.in
-mkdocs-material==9.1.14
+mkdocs-material==9.4.7
     # via -r docs/requirements.in
-mkdocs-material-extensions==1.1.1
+mkdocs-material-extensions==1.3
     # via mkdocs-material
-mkdocs-section-index==0.3.5
+mkdocs-section-index==0.3.8
     # via -r docs/requirements.in
-mkdocstrings==0.22.0
+mkdocstrings==0.23.0
     # via
     #   -r docs/requirements.in
     #   mkdocstrings-crystal
-mkdocstrings-crystal==0.3.6
+mkdocstrings-crystal==0.3.7
     # via -r docs/requirements.in
-packaging==23.1
+packaging==23.2
+    # via mkdocs
+paginate==0.5.6
+    # via mkdocs-material
+pathspec==0.11.2
+    # via mkdocs
+platformdirs==3.11.0
     # via mkdocs
-pygments==2.15.1
+pygments==2.16.1
     # via mkdocs-material
-pymdown-extensions==10.0.1
+pymdown-extensions==10.3.1
     # via
     #   -r docs/requirements.in
     #   mkdocs-code-validator
     #   mkdocs-material
     #   mkdocstrings
 python-dateutil==2.8.2
     # via ghp-import
-pyyaml==6.0
+pyyaml==6.0.1
     # via
     #   mkdocs
     #   pymdown-extensions
     #   pyyaml-env-tag
 pyyaml-env-tag==0.1
     # via mkdocs
-regex==2023.5.5
+regex==2023.10.3
     # via mkdocs-material
 requests==2.31.0
     # via mkdocs-material
 six==1.16.0
     # via python-dateutil
-urllib3==2.0.2
+urllib3==2.0.7
     # via requests
 watchdog==3.0.0
     # via mkdocs

mkdocs.yml

@@ -7,6 +7,7 @@ use_directory_urls: false
 theme:
   name: material
   features:
+    - content.action.edit
     - navigation.tabs
   logo: icon.png
   icon:
@@ -26,7 +27,9 @@ markdown_extensions:
   - pymdownx.magiclink
   - pymdownx.saneheaders
   - pymdownx.superfences
-  - pymdownx.snippets
+  - pymdownx.snippets:
+      base_path:
+        - !relative $config_dir
   - deduplicate-toc
   - callouts
   - toc:
@@ -51,3 +54,9 @@ plugins:
         crystal:
           validators:
             - crystal tool format --check -
+
+validation:
+  omitted_files: warn
+  absolute_links: warn
+  nav:
+    absolute_links: ignore