From 7f9bf357feac06bb34017e1f6c7a7730b1991ede Mon Sep 17 00:00:00 2001 From: David Smith Date: Wed, 25 Jun 2025 21:40:07 +0100 Subject: Refs #36485 -- Grouped docs checks under a unified make check target. Added a new 'check' rule to the docs Makefile which runs both the black and spelling checks. --- .../contributing/writing-documentation.txt | 23 ++++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) (limited to 'docs/internals') diff --git a/docs/internals/contributing/writing-documentation.txt b/docs/internals/contributing/writing-documentation.txt index bee0ee3886..1258d4686f 100644 --- a/docs/internals/contributing/writing-documentation.txt +++ b/docs/internals/contributing/writing-documentation.txt @@ -152,10 +152,29 @@ To edit this page, for example, we would edit the file :source:`docs/internals/contributing/writing-documentation.txt` and rebuild the HTML with ``make html``. +.. _documentation-checks: + +Documentation quality checks +---------------------------- + +Several checks help maintain Django's documentation quality, including +:ref:`spelling ` and +:ref:`code block formatting `. + +These checks are run automatically in CI and must pass before documentation +changes can be merged. They can also be run locally with a single command: + +.. console:: + + $ make check + +This command runs all current checks and will include any new checks added in +the future. + .. _documentation-spelling-check: Spelling check --------------- +~~~~~~~~~~~~~~ Before you commit your docs, it's a good idea to run the spelling checker. You'll need to install :pypi:`sphinxcontrib-spelling` first. Then from the @@ -180,7 +199,7 @@ one of the following: .. _documentation-code-block-format-check: Code block format check ------------------------ +~~~~~~~~~~~~~~~~~~~~~~~ All Python code blocks should be formatted using the :pypi:`blacken-docs` auto-formatter. This is automatically run by the :ref:`pre-commit hook -- cgit v1.3