Merge pull request #640 from itdependsnetworks/fix-docs

Fix docs

Author: itdependsnetworks

docs/requirements.txt

@@ -1,10 +1,9 @@
 mkdocs==1.6.0
-# Material for MkDocs theme
 mkdocs-material==9.5.32
-mkdocs-python-classy==0.1.3
-# Render custom markdown for version added/changed/remove notes
-mkdocs-version-annotations==1.0.0
-# Automatic documentation from sources, for MkDocs
-mkdocstrings==0.25.2
+markdown-version-annotations==1.0.1
+griffe==1.1.1
 mkdocstrings-python==1.10.8
-griffe==1.1.1
+mkdocstrings==0.25.2
+mkdocs-autorefs==1.2.0
+# Unique requirements
+mkdocs-python-classy==0.1.3

docs/user/lib_use_cases_lib_mapper.md

@@ -41,11 +41,11 @@ Another use case could be using an example like the above in an Ansible filter.
 
 ## Aerleon Mapper
 
---8<-- "docs/user/lib_mapper/aerleon.md
+--8<-- "docs/user/lib_mapper/aerleon.md"
 
 ## Reverse Aerleon Mapper
 
---8<-- "docs/user/lib_mapper/aerleon_reverse.md
+--8<-- "docs/user/lib_mapper/aerleon_reverse.md"
 
 ## Ansible Mapper
 
@@ -57,19 +57,19 @@ Another use case could be using an example like the above in an Ansible filter.
 
 ## Capirca Mapper
 
---8<-- "docs/user/lib_mapper/capirca.md
+--8<-- "docs/user/lib_mapper/capirca.md"
 
 ## Reverse Capirca Mapper
 
---8<-- "docs/user/lib_mapper/capirca_reverse.md
+--8<-- "docs/user/lib_mapper/capirca_reverse.md"
 
 ## DNA Center Mapper
 
---8<-- "docs/user/lib_mapper/dna_center.md
+--8<-- "docs/user/lib_mapper/dna_center.md"
 
 ## Reverse DNA Center Mapper
 
---8<-- "docs/user/lib_mapper/dna_center_reverse.md
+--8<-- "docs/user/lib_mapper/dna_center_reverse.md"
 
 ## Forward Networks Mapper
 
@@ -122,11 +122,11 @@ Another use case could be using an example like the above in an Ansible filter.
 
 ## NIST Mapper
 
---8<-- "docs/user/lib_mapper/nist.md
+--8<-- "docs/user/lib_mapper/nist.md"
 
 ## Reverse NIST Mapper
 
---8<-- "docs/user/lib_mapper/nist_reverse.md
+--8<-- "docs/user/lib_mapper/nist_reverse.md"
 
 ## PyATS Mapper
 

mkdocs.yml

@@ -69,6 +69,8 @@ extra:
       link: "https://twitter.com/networktocode"
       name: "Network to Code Twitter"
 markdown_extensions:
+  - "markdown_version_annotations":
+      admonition_tag: "???"
   - "admonition"
   - "toc":
       permalink: true
@@ -82,7 +84,6 @@ markdown_extensions:
   - "footnotes"
 plugins:
   - "search"
-  - "mkdocs-version-annotations"
   - "mkdocs-python-classy":
       classy_strategy: "subclass"
       classy_modules: