summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
authorJacob Walls <jacobtylerwalls@gmail.com>2025-12-02 10:25:26 -0500
committernessita <124304+nessita@users.noreply.github.com>2025-12-03 13:08:30 -0300
commitd3f142f2cd36ba0458cc679397555bd5ee7db744 (patch)
tree8e32b675c9bda300bf62a44e0827ac40fe4209bc /docs/ref
parentea4920174e3231ff5b72b3ffb2b20432671047d9 (diff)
Refs #35859 -- Clarified Tasks ref and topics docs regarding available backends.
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/tasks.txt12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/ref/tasks.txt b/docs/ref/tasks.txt
index c427c4c4d3..99d8eb6a0a 100644
--- a/docs/ref/tasks.txt
+++ b/docs/ref/tasks.txt
@@ -7,6 +7,10 @@ Tasks
.. module:: django.tasks
:synopsis: Django's built-in background Task system.
+The Task framework provides the contract and plumbing for background work, not
+the engine that runs it. The Tasks API defines how work is described, queued,
+and tracked, but leaves actual execution to external infrastructure.
+
Task definition
===============
@@ -274,6 +278,10 @@ Task errors
Backends
========
+Backends handle how Tasks are stored and executed. All backends share a common
+interface defined by ``BaseTaskBackend``, which specifies the core methods for
+enqueueing Tasks and retrieving results.
+
Base backend
------------
@@ -365,6 +373,10 @@ Feature :class:`.DummyBackend` :class:`.ImmediateBackend`
Available backends
------------------
+Django includes only development and testing backends. These support local
+execution and inspection, for production ready backends refer to
+:ref:`configuring-a-task-backend`.
+
Immediate backend
~~~~~~~~~~~~~~~~~