generate python docs and include in mdbook as part of deploy-book.yaml

TODO: write up instructions for how to reproduce locally -- install pipx then pydoc-markdown then ... see ./github/workflows/deploy-book.yaml

.github/workflows/deploy-book.yaml

@@ -32,11 +32,19 @@ jobs:
       MDBOOK_VERSION: 0.4.21
     steps:
       - uses: actions/checkout@v3
-      - name: Install mdBook
+      - name: Install mdBook and supporting dependencies
         run: |
           curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf -y | sh
           rustup update
           cargo install --version ${MDBOOK_VERSION} mdbook
+      - name: Build python docs
+        run: 
+          sudo apt update
+          sudo apt install pipx
+          pipx ensurepath
+          pipx install pydoc-markdown
+          pydoc-markdown -I python/ -p fastsim --render-toc > docs/src/python_docs.md
+
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v3

docs/.gitignore

@@ -1 +1,2 @@
-book/
+book/
+src/python_docs.md

docs/src/SUMMARY.md

@@ -1,4 +1,7 @@
 # Summary
 
 - [Introduction](./intro.md)
+- [Documentation](./fastsim-doc.md)
+    - [Python](./python-doc.md)
+    - [Rust](./rust-doc.md)
 - [How to Update This Book](./how-to-update.md)

docs/src/fastsim-doc.md

@@ -0,0 +1,5 @@
+# Documentation
+
+## [Python](./python-doc.md)
+
+## [Rust](./rust-doc.md)