docs(rtd): generate Reference Pages from workflow yaml files on CI

.readthedocs.yaml

@@ -26,9 +26,10 @@ build:
       - python -m poetry export -o req-docs.txt -E docs
     # post_install:
     #   - python -m pip install -e .
-    # pre_build:
-    #   - python ./scripts/visualize-ga-workflow.py > ./docs/cicd_mermaid.md
-
+    pre_build:
+      - chmod +x ./scripts/gen-workflow-ref.py
+      - ./scripts/gen-workflow-ref.py ./.github/workflows/docker.yml > ./docs/ref_docker.md
+      - ./scripts/gen-workflow-ref.py ./.github/workflows/pypi_env.yml > ./docs/ref_pypi_env.md
 
 
 # Build documentation in the "docs/" directory with mkdocs