Update doc builder dependencies

- move from python3.8 to python3.11
- move from mkdocs to properdocs (fork of mkdocs b/c mkdocs no longer
  continuing support)
- use poetry instead of requirements.txt for dependency management to
  make changes easier

Author: creisle

.github/workflows/publish-docs.yml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: [3.8]
+        python-version: [3.11]
     steps:
     - name: checkout
       uses: actions/checkout@v1
@@ -23,9 +23,10 @@ jobs:
     - name: install dependencies
       run: |
         python -m pip install --upgrade pip setuptools
-        pip install -r requirements.txt
+        pip install poetry
+        poetry install
     - run: bash docs/build_external.sh
-    - run: mkdocs build
+    - run: properdocs build
     - name: Deploy
       uses: peaceiris/actions-gh-pages@v3
       with:

README.md

@@ -27,15 +27,16 @@ will be updated on merge to the master branch of this repository.
 First, set up a virtual environment (Optional but recommended)
 
 ```bash
-python3.8 -m venv venv
+python3.11 -m venv venv
 source venv/bin/activate
 pip install -U setuptools pip
 ```
 
 Install the python dependencies
 
 ```bash
-pip install -r requirements.txt
+pip install poetry
+poetry install
 ```
 
 Run the script to pull the other respository files
@@ -47,5 +48,5 @@ bash docs/build_external.sh
 And finally serve the documentation for viewing locally with
 
 ```bash
-mkdocs serve
+properdocs serve
 ```