id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
37142	Document and move django.utils.deprecation.django_file_prefixes	Jacob Walls		"I'm preparing a documentation section ""Writing your own fetch mode"" as suggested in a [https://github.com/django/django/pull/17554#discussion_r2345545473 review of the feature].

Emitting a warning rather than an exception is the most obvious simple use case. I'd like my example to skip over Django frames when emitting the warning, just like we do for deprecations. So, I'd like to import and use `django_file_prefixes()` for this.

But:
- it's not documented (except for the contributing documentation, see 9932866e3a7693930a90a924014c10614820ea70)
- it lives in `.deprecation`

We have 4 +1s for moving it out of `.deprecation` in this [https://github.com/django/django/pull/19887#discussion_r2373952228 review thread].

I propose to move it and document it (outside the contributor documentation), to make it public API."	Cleanup/optimization	new	Utilities	dev	Normal				Unreviewed	0	0	0	0	0	0