summaryrefslogtreecommitdiff
path: root/docs/internals/contributing/writing-code
diff options
context:
space:
mode:
authorThibaud Colas <thibaudcolas@gmail.com>2023-10-05 06:11:57 +0100
committerSarah Boyce <42296566+sarahboyce@users.noreply.github.com>2025-07-23 16:40:51 +0200
commit5527df91921b54b9fd1eb9aca3aabe91ec58a9c7 (patch)
treee26d35cb9183a6595e86c4585c37e6539f6aae1b /docs/internals/contributing/writing-code
parent1ecf6889cabc9f3f60d3fdd651468cddd8f4da6e (diff)
Added accessibility guidelines for contributors.
Diffstat (limited to 'docs/internals/contributing/writing-code')
-rw-r--r--docs/internals/contributing/writing-code/index.txt1
-rw-r--r--docs/internals/contributing/writing-code/submitting-patches.txt2
-rw-r--r--docs/internals/contributing/writing-code/unit-tests.txt5
3 files changed, 8 insertions, 0 deletions
diff --git a/docs/internals/contributing/writing-code/index.txt b/docs/internals/contributing/writing-code/index.txt
index 72cc264524..a72b6c8b41 100644
--- a/docs/internals/contributing/writing-code/index.txt
+++ b/docs/internals/contributing/writing-code/index.txt
@@ -40,6 +40,7 @@ It's important to understand how we work and the conventions we adopt.
coding-style
javascript
+ ../accessibility
../committing-code
We maintain a curated list of small issues suited to first-time or less
diff --git a/docs/internals/contributing/writing-code/submitting-patches.txt b/docs/internals/contributing/writing-code/submitting-patches.txt
index b8ead27ded..9844d5e2c7 100644
--- a/docs/internals/contributing/writing-code/submitting-patches.txt
+++ b/docs/internals/contributing/writing-code/submitting-patches.txt
@@ -413,6 +413,8 @@ All code changes
* If the change is backwards incompatible in any way, is there a note
in the release notes (``docs/releases/A.B.txt``)?
* Is Django's test suite passing?
+* If the change affects the Django admin or rendered HTML output, has
+ :ref:`accessibility testing <accessibility-testing-baseline>` been done?
All tickets
-----------
diff --git a/docs/internals/contributing/writing-code/unit-tests.txt b/docs/internals/contributing/writing-code/unit-tests.txt
index f7651f1d4f..1c993f5fc6 100644
--- a/docs/internals/contributing/writing-code/unit-tests.txt
+++ b/docs/internals/contributing/writing-code/unit-tests.txt
@@ -271,6 +271,11 @@ faster and more stable. Add the ``--headless`` option to enable this mode.
.. _selenium.webdriver: https://github.com/SeleniumHQ/selenium/tree/trunk/py/selenium/webdriver
+.. _screenshot-tests:
+
+Screenshot tests
+~~~~~~~~~~~~~~~~
+
For testing changes to the admin UI, the selenium tests can be run with the
``--screenshots`` option enabled. Screenshots will be saved to the
``tests/screenshots/`` directory.