chango.git/docs/Makefile, branch devmain

Fixed #37150 -- Made djangodocs Sphinx extension work with any html builder.

2026-06-10T00:56:35Z

Changed djangodocs extension to register DjangoHTMLTranslator for any html-format builder (in the builder-inited hook), rather than a limited list of builders at startup. That fixes missing content in dirhtml and standard html builds (including ReadTheDocs PR previews): - Missing console tabs - Empty divs for versionadded and versionchanged directives Removed JS code that depended on jQuery, which hasn't worked since Sphinx 6.0 dropped jQuery in 2023: - Unnecessary console tabs click handling. (Console tab behavior is implemented purely in CSS.) - Client-side hyperlinking of Django template tags and filters in code examples. (This is also not supported on docs.djangoproject.com.) Removed custom DjangoStandaloneHTMLBuilder and "djangohtml" builder type. Its sole purpose was to generate the "templatebuiltins.js" file used for the (non-functional) client-side template filter/tag linking. Changed docs "make html" target from "djangohtml" to standard "html".

Aligned docs checks between GitHub Actions and local development.

2026-03-02T18:05:31Z

Fixed #36485 -- Added lint-docs check in Tox and GitHub Actions.

2025-08-25T13:51:10Z

The `check` docs target now runs spelling, black, and lint, so all current documentation quality checks can be run with a single command. Also documented the lint-docs check's availability and usage.

Refs #36485 -- Added sphinx-lint support and make lint rule for docs.

2025-08-25T13:51:10Z

This adds a `lint.py` script to run sphinx-lint on Django's docs files, a mathing `lint` target in the `docs/Makefile` and `docs/make.bat`, and updates `docs/requirements.txt` accordingly.

Refs #36485 -- Grouped docs checks under a unified make check target.

2025-08-05T15:18:19Z

Added a new 'check' rule to the docs Makefile which runs both the black and spelling checks.

Fixed #36162 -- Fixed the `black` Makefile docs rule to work on macOS.

2025-02-02T01:27:38Z

The `make black` target in the docs directory used Linux-specific syntax for its `find` command. Changed to syntax that also works on macOS and other BSD Unix variants.

Added parallelism support via --jobs to docs build Makefile rule.

2024-11-27T21:15:25Z

Used webbroswer module in docs Makefile.

2024-10-24T08:45:44Z

Refs #34140 -- Added configurations to run blacken-docs linter and adjusted docs.

2023-03-01T12:02:57Z

This adds: - GitHub actions, - tox configuration, - pre-commit hook, and - makefile rules to run blacken-docs linter. Co-authored-by: David Smith

Fixed #33753 -- Fixed docs build on Sphinx 5+.

2022-06-01T10:13:15Z

Empty language is not supported anymore.