summaryrefslogtreecommitdiff
path: root/docs/internals
AgeCommit message (Collapse)Author
2025-03-31[5.2.x] Fixes #36215 -- Included unpacking generalization notes in coding ↵Aarni Koskela
style guide (PEP-448). Backport of 6b3250673937b105af44f2f14247e56876f8dbe1 from main.
2025-03-21[5.2.x] Documented the updating of translation catalogs in post-release tasks.Sarah Boyce
Co-authored-by: Natalia <124304+nessita@users.noreply.github.com> Backport of 922c1c732a47c02aa5ef28b0b1a2bd9bc9b92d87 from main.
2025-03-18[5.2.x] Refs #35980 -- Updated internal docs for artifact upload and release ↵Baptiste Mispelon
via admin site. Recent updates to djangoproject.com extended the `Release` model to support uploading and storing artifacts and checksum files. This branch updates the "How to release Django" docs to match the new release flow. Backport of 08dae5bd46a02a2e2798028c83d97b1894beffb8 from main.
2025-02-24[5.2.x] Added security guideline on reasonable size limitations when ↵Sarah Boyce
rendering content via the DTL. This also removes the need to add warnings for every Django template filter. Backport of 582ba18d56167587e290545f113d3956e73a5801 from main.
2025-02-24[5.2.x] Added security reporting guidelines.Sarah Boyce
Backport of 59353360590202fab04067e23214a825157c524b from main.
2025-02-24[5.2.x] Updated expectations for when security reports will receive a reply.Sarah Boyce
Backport of cecb76a942e4c9df518df098b1e62778cfe20f06 from main.
2025-02-19[5.2.x] Fixed #35908 -- Retired the django-developers and django-users ↵Sarah Boyce
mailing lists. Co-authored-by: Chaitanya Rahalkar <chaitanyarahalkar@squareup.com> Backport of 86493307f97b9795a74227b6af2d59a267160847 from main.
2025-02-10[5.2.x] Specified "django" repository for twine call in ↵Mariusz Felisiak
docs/internals/howto-release-django.txt. It's necessary to specify a repository for `.pypirc` user configurations with multiple per-project PyPI tokens. Follow up to 26aedbbc0835df83140c7424df62bda03382f598. Backport of 0dc61495b2217e9c5a872ac967dfcf197d342c84 from main.
2025-02-04[5.2.x] Refs #35612 -- Extended docs on how the security team evaluates reports.nessita
Co-authored-by: Shai Berger <shai@platonix.com> Backport of f609a2da868b2320ecdc0551df3cca360d5b5bc3 from main.
2025-01-28[5.2.x] Clarified the Releaser's discretion for determining and postponing ↵Sarah Boyce
the release date. Backport of 8a6b4175d790424312965ec77e4e9b072fba188b from main.
2025-01-28[5.2.x] Updated the release process documentation to reflect the current ↵Sarah Boyce
process. Backport of 0ba35a49481c9fec4731ca0dd2230d8d48f51389 from main.
2025-01-23[5.2.x] Clarified feature freeze tasks in ↵nessita
docs/internals/howto-release-django.txt. Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com> Backport of f133285a9a7f3647fd55abc2e57b8a9a2c11ac94 from main.
2025-01-22[5.2.x] Fixed #36125 -- Switched docs to use chat.djangoproject.com when ↵Baptiste Mispelon
referencing the Discord server. Backport of 9a1f18635ff034b039c24ed5121cced028fc27d0 from main.
2025-01-20[5.2.x] Refs #32193 -- Updated python-memcached to pymemcache in ↵Mariusz Felisiak
contributing guide. Follow up to 05f3a6186efefc9fca2204a745b992501c6fd91f. Backport of 337c641abb36b3c2501b14e1290b800831bb20ad from main
2025-01-08Fixed #35999 -- Removed #django IRC channel references where appropriate.Sarah Boyce
Some references are replaced with links to the Django Discord server.
2025-01-06Refs #35444 -- Deprecated contrib.postgres aggregates ordering for order_by.Chris Muthig
Aligns the argument with SQL standards already used in Window.order_by and sets up for adding support to Aggregate.
2024-11-28Fixed #35530 -- Deprecated request.user fallback in auth.login and auth.alogin.Jaap Roes
2024-11-27Removed trailing whitespace in docs.Adam Zapletal
2024-11-14Replaced message suggestions from IRC to Discord in contributing docs.AfiMaameDufie
2024-11-11Refs #32365 -- Removed pytz from list of test dependencies in unit test docs.Mariusz Felisiak
Follow up to e6f82438d4e3750e8d299bfd79dac98eebe9f1e0.
2024-11-06Fixed #35863 -- Replaced bold text with heading level 3 in new contributors ↵ssanger
docs. This improves accessibility for screen reader users, see WCAG SC 1.3.1 Info and Relationships: https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html
2024-11-05Clarified instructions on how to claim a ticket.Maria Hynes
2024-11-05Fixed typo in docs/internals/howto-release-django.txt.Mariusz Felisiak
2024-10-30Fixed #35866 -- Clarified the positioning Python magic methods on models in ↵maddrum
the internal style guide.
2024-10-25Improved the writing documentation contributing guide.Paolo Melchiorre
2024-10-25Improved readability of triage workflow image by increasing its size and ↵mbcodes
color contrast.
2024-10-16Expanded contributor docs on getting feedback from the wider community.Maryam Yusuf
2024-10-11Fixed #35612 -- Added documentation on how the security team evaluates reports.Sarah Boyce
Co-authored-by: Joshua Olatunji <joshua+github@etentlabs.com>
2024-09-23Made cosmetic edits to the Steering council docs.Sarah Boyce
2024-09-16Removed setting the release schedule from Steering Council prerogatives as ↵Sarah Boyce
per DEP 44.
2024-08-28Fixed #35666 -- Documented stacklevel usage and testing, and adjusted test ↵Simon Charette
suite accordingly. Over the years we've had multiple instances of hit and misses when emitting warnings: either setting the wrong stacklevel or not setting it at all. This work adds assertions for the existing warnings that were declaring the correct stacklevel, but were lacking tests for it.
2024-08-05Used :pypi: role in docs where appropriate.Mariusz Felisiak
2024-07-29Fixed #35546 -- Emphasised accepted ticket requirement in contributing docs.Maryam Yusuf
2024-07-29Referenced joining the triage and review team as motivation to do PR reviews.Maryam Yusuf
2024-07-25Added contributor guidelines for performance optimizations.Sarah Boyce
2024-07-24Updated asgiref dependency for 5.1 release series.Mariusz Felisiak
2024-07-04Replaced usage of "patch" with more precise terms in contributing docs.Andreu Vallbona
2024-06-28Refs #22712 -- Corrected deprecation of "all" argument in ↵Mariusz Felisiak
django.contrib.staticfiles.finders.find(). Features deprecated in Django 5.2 should be removed in Django 6.1.
2024-06-24Migrated setuptools configuration to pyproject.toml.Claude Paroz
This branch migrates setuptools configuration from setup.py/setup.cfg to pyproject.toml. In order to ensure that the generated binary files have consistent casing (both the tarball and the wheel), setuptools version is limited to ">=61.0.0,<69.3.0". Configuration for flake8 was moved to a dedicated .flake8 file since it cannot be configured via pyproject.toml. Also, __pycache__ exclusion was removed from MANIFEST and the extras/Makefile was replaced with a simpler build command. Co-authored-by: Nick Pope <nick@nickpope.me.uk>
2024-05-22Advanced deprecation warnings for Django 5.2.Natalia
2024-05-21Fixed #35405 -- Converted get_cache_name into a cached property in ↵Adam Johnson
FieldCacheMixin. FieldCacheMixin is used by related fields to track their cached values. This work migrates get_cache_name() to be a cached property to optimize performance by reducing unnecessary function calls when working with related fields, given that its value remains constant. Co-authored-by: Simon Charette <charette.s@gmail.com> Co-authored-by: Sarah Boyce <42296566+sarahboyce@users.noreply.github.com> Co-authored-by: Natalia <124304+nessita@users.noreply.github.com>
2024-05-21Fixed #35326 -- Added allow_overwrite parameter to FileSystemStorage.Ben Cail
2024-05-10Updated docs for the Django release process.nessita
2024-05-02Added a high contrast mode to screenshot cases.Sarah Boyce
Thank you to Sarah Abderemane and Nick Pope for the reviews.
2024-04-10Updated docs for updating translations in ↵nessita
docs/internals/howto-release-django.txt. Co-authored-by: Mariusz Felisiak <felisiak.mariusz@gmail.com>
2024-03-11Fixed #14831 -- Extended template style guide in docs.Ryan Cheley
2024-03-06Fixed broken links and redirects in docs.Mariusz Felisiak
2024-03-01Refs #35234 -- Deprecated CheckConstraint.check in favor of .condition.Simon Charette
Once the deprecation period ends CheckConstraint.check() can become the documented method that performs system checks for BaseConstraint subclasses.
2024-02-23Fixed #35090 -- Deprecated registering URL converters with the same name.Salvo Polizzi
2024-02-08Fixed typo in docs/internals/contributing/writing-code/coding-style.txt.Koo