Re: [Django] #37142: Move django.utils.deprecation.django_file_prefixes to a dedicated warnings module. (was: Document and move django.utils.deprecation.django_file_prefixes)

[Django]

#37142: Move django.utils.deprecation.django_file_prefixes to a dedicated warnings
module.
-------------------------------------+-------------------------------------
Reporter: Jacob Walls | Owner: zky
Type: | Status: closed
Cleanup/optimization |
Component: Utilities | Version: dev
Severity: Normal | Resolution: fixed
Keywords: | Triage Stage: Ready for
| checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Changes (by Natalia Bidart):

* summary: Document and move django.utils.deprecation.django_file_prefixes
=>
Move django.utils.deprecation.django_file_prefixes to a dedicated
warnings module.

Comment:

Jacob and I discussed these changes and we agreed the documentation
additions should be reverted. While django_file_prefixes() is a handy
utility that sets a good example for issuing warnings, it is an internal
helper and documenting it implies public API support and a stability
commitment we do not intend to make (at least not for now).
--
Ticket URL: <https://code.djangoproject.com/ticket/37142#comment:8>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.