Readme: clarify intro; update ESP list; update docs links

This commit is contained in:
medmunds
2022-05-03 12:02:17 -07:00
parent c7288b9b72
commit 4656b3d6dc

View File

@@ -19,19 +19,31 @@ Anymail: Django email integration for transactional ESPs
.. This shared-intro section is also included in docs/index.rst .. This shared-intro section is also included in docs/index.rst
Anymail integrates several transactional email service providers (ESPs) into Django, Anymail lets you send and receive email in Django using your choice
with a consistent API that lets you use ESP-added features without locking your code of transactional email service providers (ESPs). It extends the
to a particular ESP. standard `django.core.mail` with many common ESP-added features, providing
a consistent API that avoids locking your code to one specific ESP
(and making it easier to change ESPs later if needed).
It currently fully supports **Amazon SES, Mailgun, Mailjet, Postmark, SendinBlue, SendGrid,** Anymail currently supports these ESPs:
and **SparkPost,** and has limited support for **Mandrill.**
Anymail normalizes ESP functionality so it "just works" with Django's * **Amazon SES**
built-in `django.core.mail` package. It includes: * **Mailgun**
* **Mailjet**
* **Mandrill** (MailChimp transactional)
* **Postal** (self-hosted ESP)
* **Postmark**
* **SendGrid**
* **SendinBlue**
* **SparkPost**
* Support for HTML, attachments, extra headers, and other features of Anymail includes:
* Integration of each ESP's sending APIs into
`Django's built-in email <https://docs.djangoproject.com/en/stable/topics/email/>`_ `Django's built-in email <https://docs.djangoproject.com/en/stable/topics/email/>`_
* Extensions that make it easy to use extra ESP functionality, like tags, metadata, package, including support for HTML, attachments, extra headers,
and other standard email features
* Extensions to expose common ESP-added functionality, like tags, metadata,
and tracking, with code that's portable between ESPs and tracking, with code that's portable between ESPs
* Simplified inline images for HTML email * Simplified inline images for HTML email
* Normalized sent-message status and tracking notification, by connecting * Normalized sent-message status and tracking notification, by connecting
@@ -44,7 +56,7 @@ Anymail maintains compatibility with all Django versions that are in mainstream
or extended support, plus (usually) a few older Django versions, and is extensively or extended support, plus (usually) a few older Django versions, and is extensively
tested on all Python versions supported by Django. (Even-older Django versions tested on all Python versions supported by Django. (Even-older Django versions
may still be covered by an Anymail extended support release; consult the may still be covered by an Anymail extended support release; consult the
`changelog <https://anymail.readthedocs.io/en/stable/changelog/>`_ for details.) `changelog <https://anymail.dev/en/stable/changelog/>`_ for details.)
Anymail releases follow `semantic versioning <https://semver.org/>`_. Anymail releases follow `semantic versioning <https://semver.org/>`_.
The package is released under the BSD license. The package is released under the BSD license.
@@ -60,15 +72,15 @@ The package is released under the BSD license.
:alt: integration test status in GitHub Actions :alt: integration test status in GitHub Actions
.. image:: https://readthedocs.org/projects/anymail/badge/?version=stable .. image:: https://readthedocs.org/projects/anymail/badge/?version=stable
:target: https://anymail.readthedocs.io/en/stable/ :target: https://anymail.dev/en/stable/
:alt: documentation on ReadTheDocs :alt: documentation build status on ReadTheDocs
**Resources** **Resources**
* Full documentation: https://anymail.readthedocs.io/en/stable/ * Full documentation: https://anymail.dev/en/stable/
* Package on PyPI: https://pypi.org/project/django-anymail/ * Package on PyPI: https://pypi.org/project/django-anymail/
* Project on Github: https://github.com/anymail/django-anymail * Project on Github: https://github.com/anymail/django-anymail
* Changelog: https://anymail.readthedocs.io/en/stable/changelog/ * Changelog: https://anymail.dev/en/stable/changelog/
Anymail 1-2-3 Anymail 1-2-3
@@ -156,6 +168,6 @@ or SparkPost or any other supported ESP where you see "mailgun":
.. END quickstart .. END quickstart
See the `full documentation <https://anymail.readthedocs.io/en/stable/>`_ See the `full documentation <https://anymail.dev/en/stable/>`_
for more features and options, including receiving messages and tracking for more features and options, including receiving messages and tracking
sent message status. sent message status.