From a5f8430f5b35c2022628763b4a8301af437f2685 Mon Sep 17 00:00:00 2001
From: fjetter <fjetter@users.noreply.github.com>
Date: Fri, 19 Jul 2024 16:26:09 +0200
Subject: [PATCH] leave a warning about future instantiation

---
 distributed/client.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/distributed/client.py b/distributed/client.py
index b5c6eb3789..ad283a352a 100644
--- a/distributed/client.py
+++ b/distributed/client.py
@@ -253,6 +253,11 @@ class Future(WrappedKey):
     manages future objects in the local Python process to determine what
     happens in the larger cluster.
 
+    .. note::
+
+        Users should not instantiate futures manually. This can lead to state
+        corruption and deadlocking clusters.
+
     Parameters
     ----------
     key: str, or tuple