From f42b89f1bf49a5b89ed852b60f79342320a81c5e Mon Sep 17 00:00:00 2001 From: Mike Edmunds Date: Wed, 16 Jul 2025 04:49:03 -0700 Subject: Fixed #36477, Refs #36163 -- Added @deprecate_posargs decorator to simplify deprecation of positional arguments. This helper allows marking positional-or-keyword parameters as keyword-only with a deprecation period, in a consistent and correct manner. --- docs/internals/contributing/writing-code/submitting-patches.txt | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'docs/internals/contributing/writing-code') diff --git a/docs/internals/contributing/writing-code/submitting-patches.txt b/docs/internals/contributing/writing-code/submitting-patches.txt index fe354a0ba1..b8ead27ded 100644 --- a/docs/internals/contributing/writing-code/submitting-patches.txt +++ b/docs/internals/contributing/writing-code/submitting-patches.txt @@ -312,6 +312,11 @@ Once you have completed these steps, you are finished with the deprecation. In each :term:`feature release `, all ``RemovedInDjangoXXWarning``\s matching the new version are removed. +The ``django.utils.deprecation`` module provides some helpful deprecation +utilities, such as a ``@deprecate_posargs`` decorator to assist with converting +positional-or-keyword arguments to keyword-only. See the inline documentation +in the module source. + JavaScript contributions ======================== -- cgit v1.3