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
35908	Retire django-developers and django-users mailing list	Thibaud Colas		"Following the forum thread ([https://forum.djangoproject.com/t/proposal-retiring-django-users-and-django-developers-mailing-lists/35747 Proposal: retiring django-users and django-developers mailing lists]), we can now move ahead with updating the developer documentation to remove or contextualize references to the django-developers and django-users mailing list.

There is a lot of content that needs removing, but in some cases it might make sense to replace the references to those mailing lists with a link to the Django Forum, or specific forum categories. Also worth noting the django-announce and django-updates mailing list are staying as-is.

== Removal tasks

- [ ] remove 2x mailing lists from the [https://github.com/django/django/blob/main/docs/internals/howto-release-django.txt#L132 How to release Django] docs
- [ ] Remove django-users from the [https://github.com/django/django/blob/main/docs/faq/help.txt#L24 FAQ - How do I do X]
- [ ] Remove [https://github.com/django/django/blob/main/docs/faq/help.txt#L44 Why hasn't my message appeared on *django-users*?] from the FAQ: Getting help
- [ ] Remove [https://github.com/django/django/blob/main/docs/faq/help.txt#L71 You might notice we have a second mailing list] paragraph from the FAQ: Getting help
- [ ] Remove the 4x subscription and posting email addresses from  [https://github.com/django/django/blob/main/docs/internals/mailing-lists.txt#L33 Mailing lists and Forum]
- [ ] Remove the django-users mention on the [https://github.com/django/django/blob/main/docs/internals/contributing/index.txt#L29 Contributing to Django] index.
- [ ] Remove 4x mentions of django-developers from the [https://github.com/django/django/blob/main/docs/internals/organization.txt#L218 Organization of the Django Project] docs
- [ ] Remove 3x django-developers mentions on [https://github.com/django/django/blob/main/docs/internals/contributing/committing-code.txt#L113 Comitting code]
- [ ] Remove 6x django-developers mentions on [https://github.com/django/django/blob/main/docs/internals/contributing/triaging-tickets.txt#L312 Triaging tickets]
- [ ] Remove 4x django-developers mentions on [https://github.com/django/django/blob/main/docs/internals/contributing/writing-code/submitting-patches.txt#L157 Submitting contributions]
- [ ] Remove 1x django-developers mention from [https://github.com/django/django/blob/main/docs/intro/contributing.txt#L44 Writing your first contribution for Django]

== Rewrite tasks

- [ ] Rewrite the [https://github.com/django/django/blob/main/docs/internals/mailing-lists.txt#L33 Mailing lists and Forum] explanations for django-users and django-developers to explain the mailing lists still exist and contain valuable history
- [ ] Replace the 4x django-users and django-developers mentions on [https://github.com/django/django/blob/main/docs/internals/contributing/bugs-and-features.txt#L20 Reporting bugs and requesting features] to instead point to the forum
- [ ] Replace the django-users and IRC links on the [https://github.com/django/django/blob/main/docs/intro/whatsnext.txt#L126 What to read next] with a link to the [https://www.djangoproject.com/community/ Django Community] page
- [ ] Replace the django-users mention on [https://github.com/django/django/blob/main/docs/ref/contrib/index.txt#L141 contrib apps index] with a link to the Django forum

== Do nothing

- Keep the `rst_epilog` references in the Sphinx config for now
- Keep any references to the mailing lists in historical docs (for example old release notes)"	Cleanup/optimization	new	Documentation	5.1	Normal		community, docs, support, onboarding		Unreviewed	0	0	0	0	0	0