#36524: EmailMessage method documentation cannot be cross referenced
-------------------------------------+-------------------------------------
Reporter: Mike Edmunds | Owner: Mike
Type: | Edmunds
Cleanup/optimization | Status: assigned
Component: Core (Mail) | Version: 5.2
Severity: Normal | Resolution:
Keywords: email | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Mike Edmunds):
I've been wanting to reorganize email.txt for a while. Based on the
questions I've seen in the forums (and in the django-anymail repo), and
the large number of "how to send email with Django" tutorials out there, I
think the current organization is not serving users particularly well.
I'll try to put together an outline for a revision, maybe for forum
discussion? And then we could figure out if there's an incremental series
of changes to get there, starting with splitting out the API reference.
In the meantime, though, I'd really like to be able to use
`:method:django.core.mail.EmailMessage.attach` etc. in the docs. I'll open
a PR for that after the modern email API one lands.
--
Ticket URL: <https://code.djangoproject.com/ticket/36524#comment:7>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion visit
https://groups.google.com/d/msgid/django-updates/010701983d8adf29-236e6d67-91d4-4494-841c-c092373d18dd-000000%40eu-central-1.amazonses.com.
