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:42:23 +0200
commit6e71386118b1e9af0bf60b75ad9549aa5df2192d (patch)
tree7f24db4ae09b3d39a9369c807feaa875d23e8362 /docs/internals/contributing/writing-code
parent6966adc519ccb09a1e72ffd1c37489e85d675556 (diff)
[5.2.x] Added accessibility guidelines for contributors.
Backport of 5527df91921b54b9fd1eb9aca3aabe91ec58a9c7 from main.
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 fe354a0ba1..5fe3a151de 100644
--- a/docs/internals/contributing/writing-code/submitting-patches.txt
+++ b/docs/internals/contributing/writing-code/submitting-patches.txt
@@ -408,6 +408,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 71aaa6dccb..03218e26cc 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.