docs: update requirements.txt and bump to 3.11 (#1011)

.github/workflows/docs.yml

@@ -25,9 +25,9 @@ jobs:
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v4.3.0
+      - uses: actions/setup-python@v4.5.0
         with:
-          python-version: 3.9
+          python-version: 3.11
 
       - name: Install Python dependencies
         run: pip install -r docs/requirements.txt

.github/workflows/post-release.yml

@@ -35,9 +35,9 @@ jobs:
             exit 1
           fi
 
-      - uses: actions/setup-python@v4.3.0
+      - uses: actions/setup-python@v4.5.0
         with:
-          python-version: 3.9
+          python-version: 3.11
 
       - name: Install Python dependencies
         run: pip install -r docs/requirements.txt

.github/workflows/test-docs.yml

@@ -33,9 +33,9 @@ jobs:
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v4.3.0
+      - uses: actions/setup-python@v4.5.0
         with:
-          python-version: 3.9
+          python-version: 3.11
 
       - name: Install Python dependencies
         run: pip install -r docs/requirements.txt

docs/README.md

@@ -3,6 +3,8 @@
 This is where the extended documentation resides, hosted on GitHub Pages. We use [MkDocs](https://www.mkdocs.org/),
 [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/), and [mike](https://github.com/jimporter/mike).
 
+Documentation is currently built using Python 3.11, though it should work fine with older versions.
+
 ## Running locally
 
 ```bash

docs/content/contribution/documentation.md

@@ -35,10 +35,13 @@ There are a few areas where documentation changes are often needed:
 
    <h3>Extended documentation</h3>
 
-   For changes to the extended documentation, you'll probably want [MkDocs](https://www.mkdocs.org/), [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/), `mdx_truly_sane_lists`, and optionally [Mike](https://github.com/jimporter/mike) installed to provide live reloading and preview for your changes. They aren't needed but it'll help with validating your changes.
+   For changes to the extended documentation, you'll probably want Python 3.11 (older versions should be fine though),
+   [MkDocs](https://www.mkdocs.org/), [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/),
+   `mdx_truly_sane_lists`, and optionally [Mike](https://github.com/jimporter/mike) installed to provide live reloading
+   and preview for your changes. They aren't needed but it'll help with validating your changes.
 
-   You can do so through `pip` or your system's package managers. If you use `pip`, you can use venv to install the
-   documentation dependencies:
+   You can do so through `pip` or your system's package managers. If you use `pip`, you can use venv to cleanly install
+   the documentation dependencies:
 
    ```bash
    # Change directories to the documentation.

docs/requirements.txt

@@ -1,5 +1,5 @@
-mkdocs == 1.4.1
-mkdocs-material == 8.5.7
+mkdocs == 1.4.2
+mkdocs-material == 9.0.10
 mkdocs-material-extensions == 1.1.0
 mdx_truly_sane_lists == 1.3
 mike == 1.1.2