Fix GitHub workflows and mkdocs versioning

.github/workflows/ci-docs.yml

@@ -17,12 +17,12 @@ jobs:
       - uses: actions/setup-python@v4
         with:
           python-version: 3.9
-      - uses: Gr1N/setup-poetry@v8
-      - name: Cache Python dependencies
-        uses: actions/cache@v3
-        with:
-          path: ~/.cache/pypoetry/virtualenvs
-          key: ${{ runner.os }}-poetry-${{ hashFiles('poetry.lock') }}
+      - name: Install Poetry
+          uses: snok/install-poetry@v1
+          with:
+            version: "1.8.3"         # pin a known-good version instead of "latest"
+            virtualenvs-create: true
+            virtualenvs-in-project: true
       - name: Install python dependencies
         run: poetry install
       - name: Build and deploy docs

.github/workflows/pytest.yml

@@ -16,11 +16,16 @@ jobs:
         - uses: actions/setup-python@v5
           with:
             python-version: ${{ matrix.python_version }}
-        - uses: Gr1N/setup-poetry@v9
+        - name: Install Poetry
+          uses: snok/install-poetry@v1
+          with:
+            version: "1.8.3"         # pin a known-good version instead of "latest"
+            virtualenvs-create: true
+            virtualenvs-in-project: true
         - name: Cache Python dependencies
           uses: actions/cache@v4
           with:
-            path: ~/.cache/pypoetry/virtualenvs
+            path: .venv
             key: ${{ runner.os }}-poetry-${{ hashFiles('poetry.lock') }}
 
         - name: Install python dependencies

CHANGELOG.md

@@ -10,12 +10,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 #### Changed
 
+- Update github actions installation procedures to use a maintained poetry installer [#623](https://github.com/askap-vast/vast-tools/pull/623)
+- Pin mkdocs-material to a sensible version [#623](https://github.com/askap-vast/vast-tools/pull/623)
+
 #### Fixed
 
 #### Removed
 
 #### List of PRs
 
+- Update github actions installation procedures to use a maintained poetry installer and pin mkdocs-material to a sensible version: fix, docs: [#623](https://github.com/askap-vast/vast-tools/pull/623)
 
 ## [3.3.0](https://github.com/askap-vast/vast-tools/releases/v3.3.0) (2026-07-20)
 

pyproject.toml

@@ -37,6 +37,7 @@ svgpath2mpl = "^1.0.0"
 setuptools = "^70.0.0"
 pydantic = "<2.0.0"
 jplephem = "^2.23"
+mkdocs-material = "<9.6.10"
 
 [tool.poetry.group.dev.dependencies]
 ipdb = "^0.13.6"