Merge branch 'master' into ruff

.github/workflows/rstcheck.yml

@@ -14,12 +14,5 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-      - name: Install dependencies
-        run: |
-          python -m pip install rstcheck
       - name: Run rstcheck
-        run: |
-          python -m rstcheck --ignore-directives autofunction README.rst reference/*.rst
+        run: make rstcheck

Makefile

@@ -0,0 +1,6 @@
+lint:
+# ignore errors for long lines and multi-statement lines
+	@pipx run flake8 --ignore=E501,E701,W503 .
+
+rstcheck:
+	@pipx run rstcheck --ignore-directives autofunction README.rst reference/*.rst

README.rst

@@ -296,6 +296,8 @@ Releases are done by running ``make-release.sh VERSION_GOES_HERE`` to build the
 Testing
 ~~~~~~~
 
+Prerequisite: `Install pipx <https://pipx.pypa.io/stable/installation/>`__.
+
 To run all the tests:
 
 .. code:: bash
@@ -312,7 +314,7 @@ To ensure RST is well-formed:
 
 .. code:: bash
 
-    python -m rstcheck README.rst reference/*.rst
+    make rstcheck
 
 Testing is also done automatically by GitHub Actions, upon every push.