Accessibility test Kitchen Sink with Playwright

docs/community/setup.md

@@ -161,19 +161,28 @@ will cause the development server to do the following:
 
 ## Run the tests
 
-This theme uses `pytest` for its testing, with a lightweight fixture defined
+This theme uses `pytest` for its testing. There is a lightweight fixture defined
 in the `test_build.py` script that makes it easy to run a Sphinx build using
-this theme and inspect the results.
+this theme and inspect the results. There are also accessibility checks in
+`test_accessibilty.py`.
 
-In addition, we use [pytest-regressions](https://pytest-regressions.readthedocs.io/en/latest/)
-to ensure that the HTML generated by the theme is what we'd expect. This module
+In addition, we use
+[pytest-regressions](https://pytest-regressions.readthedocs.io/en/latest/) to
+ensure that the HTML generated by the theme is what we'd expect. This module
 provides a `file_regression` fixture that will check the contents of an object
 against a reference file on disk. If the structure of the two differs, then the
 test will fail. If we _expect_ the structure to differ, then delete the file on
-disk and run the test. A new file will be created, and subsequent tests will pass.
+disk and run the test. A new file will be created, and subsequent tests will
+pass.
 
 To run the tests with `nox`, run the following command:
 
 ```console
 $ nox -s test
 ```
+
+To run just the accessibility tests:
+
+```console
+$ nox -s test -- -k accessibility
+```

docs/community/topics/accessibility.md

@@ -1,5 +1,9 @@
 # Accessibility checks
 
+Note 22-March-2023: we are currently
+[re-evaluating how we do accessibility checks](https://github.com/pydata/pydata-sphinx-theme/issues/1168)
+and reporting, so this may change soon.
+
 The accessibility checking tools can find a number of common HTML patterns which
 assistive technology can't help users understand.
 We run a [Lighthouse](https://developers.google.com/web/tools/lighthouse) job in our CI/CD, which generates a "score" for all pages in our **Kitchen Sink** example documentation.

noxfile.py

@@ -71,8 +71,10 @@ def docs_live(session):
 def test(session):
     """Run the test suite."""
     if _should_install(session):
-        session.install("-e", ".[test]")
+        session.install("-e", ".[test,doc]")
+        session.run("playwright", "install")
     _compile_translations(session)
+    session.run("sphinx-build", "-b=html", "docs/", "docs/_build/html", "-v")
     session.run("pytest", *session.posargs)