diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 6eeb3925..1ae54f73 100644 --- a/.github/workflows/docs.yml +++ b/.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 diff --git a/.github/workflows/post-release.yml b/.github/workflows/post-release.yml index fdb7d493..26b6e7a4 100644 --- a/.github/workflows/post-release.yml +++ b/.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 diff --git a/.github/workflows/test-docs.yml b/.github/workflows/test-docs.yml index 219d3cb2..01dd9fe9 100644 --- a/.github/workflows/test-docs.yml +++ b/.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 diff --git a/docs/README.md b/docs/README.md index 33d89d17..528822e8 100644 --- a/docs/README.md +++ b/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 diff --git a/docs/content/contribution/documentation.md b/docs/content/contribution/documentation.md index 5a1a6ad6..616f3319 100644 --- a/docs/content/contribution/documentation.md +++ b/docs/content/contribution/documentation.md @@ -35,10 +35,13 @@ There are a few areas where documentation changes are often needed:

Extended documentation

- 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. diff --git a/docs/requirements.txt b/docs/requirements.txt index 763a3654..5cadfc7a 100644 --- a/docs/requirements.txt +++ b/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