Docs: make ESP feature matrix maintainable

(reST substitutions bring the table width back within
a normal editor's width!)

[ci skip]
This commit is contained in:
medmunds
2016-03-14 19:48:47 -07:00
parent 2b1c7d0dce
commit 12229ab116

View File

@@ -25,33 +25,38 @@ The table below summarizes the Anymail features supported for each ESP.
.. currentmodule:: anymail.message
====================================== ====================== ======================= ======================= =======================
Email Service Provider :ref:`mailgun-backend` :ref:`mandrill-backend` :ref:`postmark-backend` :ref:`sendgrid-backend`
====================================== ====================== ======================= ======================= =======================
=========================================== ========= ========== ========== ==========
Email Service Provider |Mailgun| |Mandrill| |Postmark| |SendGrid|
=========================================== ========= ========== ========== ==========
.. rubric:: :ref:`Anymail send options <anymail-send-options>`
----------------------------------------------------------------------------------------------------------------------------------------
:attr:`~AnymailMessage.metadata` Yes Yes No Yes
:attr:`~AnymailMessage.send_at` Yes Yes No Yes
:attr:`~AnymailMessage.tags` Yes Yes Max 1 tag Yes
:attr:`~AnymailMessage.track_clicks` Yes Yes No Yes
:attr:`~AnymailMessage.track_opens` Yes Yes Yes Yes
-------------------------------------------------------------------------------------------
:attr:`~AnymailMessage.metadata` Yes Yes No Yes
:attr:`~AnymailMessage.send_at` Yes Yes No Yes
:attr:`~AnymailMessage.tags` Yes Yes Max 1 tag Yes
:attr:`~AnymailMessage.track_clicks` Yes Yes No Yes
:attr:`~AnymailMessage.track_opens` Yes Yes Yes Yes
.. rubric:: :ref:`Status <esp-send-status>` and tracking
----------------------------------------------------------------------------------------------------------------------------------------
:attr:`~AnymailMessage.anymail_status` Yes Yes Yes Yes
====================================== ====================== ======================= ======================= =======================
-------------------------------------------------------------------------------------------
:attr:`~AnymailMessage.anymail_status` Yes Yes Yes Yes
=========================================== ========= ========== ========== ==========
.. Status tracking webhooks (coming) (coming) (coming) (coming)
.. Status tracking webhooks (coming)...
.. .. rubric:: :ref:`inbound`
.. ----------------------------------------------------------------------------------------------------------------------------------------
.. Inbound webhooks (coming) (coming) (coming) (coming)
.. -------------------------------------------------------------------------------------------
.. Inbound webhooks (coming)...
Trying to choose an ESP? Please **don't** start with this table. It's far more
important to consider things like an ESP's deliverability stats, latency, uptime,
and support for developers. The *number* of extra features an ESP offers is almost
meaningless. (And even specific features don't matter if you don't plan to use them.)
.. |Mailgun| replace:: :ref:`mailgun-backend`
.. |Mandrill| replace:: :ref:`mandrill-backend`
.. |Postmark| replace:: :ref:`postmark-backend`
.. |SendGrid| replace:: :ref:`sendgrid-backend`
Other ESPs
----------