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,11 +25,11 @@ The table below summarizes the Anymail features supported for each ESP.
.. currentmodule:: anymail.message .. 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>` .. rubric:: :ref:`Anymail send options <anymail-send-options>`
---------------------------------------------------------------------------------------------------------------------------------------- -------------------------------------------------------------------------------------------
:attr:`~AnymailMessage.metadata` Yes Yes No Yes :attr:`~AnymailMessage.metadata` Yes Yes No Yes
:attr:`~AnymailMessage.send_at` Yes Yes No Yes :attr:`~AnymailMessage.send_at` Yes Yes No Yes
:attr:`~AnymailMessage.tags` Yes Yes Max 1 tag Yes :attr:`~AnymailMessage.tags` Yes Yes Max 1 tag Yes
@@ -37,21 +37,26 @@ Email Service Provider :ref:`mailgun-backend` :ref:`mandrill-
:attr:`~AnymailMessage.track_opens` Yes Yes Yes Yes :attr:`~AnymailMessage.track_opens` Yes Yes Yes Yes
.. rubric:: :ref:`Status <esp-send-status>` and tracking .. 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` .. .. 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 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, 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 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.) 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 Other ESPs
---------- ----------