From 2efa5bac5726ab2edf76a3ea2de620d6b8de5180 Mon Sep 17 00:00:00 2001 From: Ilan Steemers Date: Thu, 10 Sep 2015 14:27:14 +0200 Subject: [PATCH] docs: minor adjustments --- docs/brokers.rst | 6 ++++-- docs/configure.rst | 1 + 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/brokers.rst b/docs/brokers.rst index 374e2e0..396cf0b 100644 --- a/docs/brokers.rst +++ b/docs/brokers.rst @@ -1,7 +1,7 @@ Brokers ======= -The broker sits between your Django instances and your Django Q cluster instances, accepting and delivering task packages. +The broker sits between your Django instances and your Django Q cluster instances; accepting, saving and delivering task packages. Currently we support a variety of brokers from the default Redis, bleeding edge Disque to the convenient Amazon SQS. The default Redis broker does not support message receipts. @@ -37,8 +37,10 @@ The default broker for Django Q clusters. Disque ------ -Unlike Redis, Disque supports message receipts which make delivery to the cluster workers guaranteed. If a task never produces a failed or successful result, it will automatically be sent to the cluster again for a retry. +Unlike Redis, Disque supports message receipts which make delivery to the cluster workers guaranteed. +In our tests it is as fast or faster than the Redis broker. You can control the amount of time Disque should wait for completion of a task by configuring the :ref:`retry` setting. +Bulk task retrieval is supported via the :ref:`bulk` option. * Delivery receipts * Atomic diff --git a/docs/configure.rst b/docs/configure.rst index 28daf53..7f038fa 100644 --- a/docs/configure.rst +++ b/docs/configure.rst @@ -240,6 +240,7 @@ Please make sure these credentials have proper SQS access. Amazon SQS only supports a bulk setting between 1 and 10, with the total payload not exceeding 256kb. +.. _bulk: bulk ~~~~