Add doc warnings to ensure devs understand backend resource usage (celery#4718)

* Add warnings to ensure developers understand they must process task return values to avoid resource issues.

Specifically, the resource being consumed is redis subscriptions. Unsubscribe does not occur unless the caller explicitly cleans it up.

* Remove training whitespace to pass flake check

Author: bartloop

celery/result.py

@@ -152,6 +152,13 @@ def get(self, timeout=None, propagate=True, interval=0.5,
            Waiting for tasks within a task may lead to deadlocks.
            Please read :ref:`task-synchronous-subtasks`.
 
+        Warning:
+           Backends use resources to store and transmit results. To ensure
+           that resources are released, you must eventually call
+           :meth:`[email protected]` or :meth:`[email protected]` on
+           EVERY :class:`~@AsyncResult` instance returned after calling
+           a task.
+
         Arguments:
             timeout (float): How long to wait, in seconds, before the
                 operation times out.

docs/getting-started/first-steps-with-celery.rst

@@ -271,7 +271,14 @@ original traceback:
 .. code-block:: pycon
 
     >>> result.traceback
-    …
+
+.. warning::
+
+    Backends use resources to store and transmit results. To ensure 
+    that resources are released, you must eventually call 
+    :meth:`[email protected]` or :meth:`[email protected]` on 
+    EVERY :class:`~@AsyncResult` instance returned after calling
+    a task.
 
 See :mod:`celery.result` for the complete result object reference.
 

docs/userguide/tasks.rst

@@ -1045,6 +1045,14 @@ No backend works well for every use case.
 You should read about the strengths and weaknesses of each backend, and choose
 the most appropriate for your needs.
 
+.. warning::
+
+    Backends use resources to store and transmit results. To ensure 
+    that resources are released, you must eventually call 
+    :meth:`[email protected]` or :meth:`[email protected]` on 
+    EVERY :class:`~@AsyncResult` instance returned after calling
+    a task.
+
 .. seealso::
 
     :ref:`conf-result-backend`