Suggest adt install (#124)

* Suggest adt install

* Add mkdocs macro for recommended installation

* Updated docs build command

Author: audgirka

.config/constraints.txt

@@ -48,7 +48,7 @@ markdown-include==0.8.1
 markupsafe==2.1.5
 mergedeep==1.3.4
 mkdocs==1.5.3
-mkdocs-ansible==24.2.1
+mkdocs-ansible==24.3.0
 mkdocs-autorefs==0.5.0
 mkdocs-gen-files==0.5.0
 mkdocs-htmlproofer-plugin==1.0.0

.config/requirements-docs.in

@@ -1 +1 @@
-mkdocs-ansible>=0.2.0
+mkdocs-ansible>=24.3.0

.readthedocs.yml

@@ -11,7 +11,7 @@ build:
     python: "3.11"
   commands:
     - pip install --user tox
-    - python3 -m tox -e docs -- --strict --site-dir=_readthedocs/html/
+    - python3 -m tox -e docs --  --strict --site-dir=_readthedocs/html/
 python:
   install:
     - method: pip

docs/index.md

@@ -18,8 +18,13 @@ By placing collections into the python site-packages directory they are discover
 
 ### Setting up a development environment
 
+{{ install_from_adt("ansible-dev-environment") }}
+
+```bash
+pip install ansible-dev-environment --user
+```
+
 ```
-$ pip install ansible-dev-environment --user
 $ git clone <collection_repo>
 $ cd <collection_repo>
 $ ade install -e .\[test] --venv venv

mkdocs.yml

@@ -45,6 +45,8 @@ nav:
 
 plugins:
   - autorefs
+  - macros:
+      modules: [mkdocs-ansible:mkdocs_ansible]
   - markdown-exec
   - material/search:
       separator: '[\s\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'