From f809ce90337693abe9e337f1491a4727dd678e2e Mon Sep 17 00:00:00 2001
From: Erik Montnemery <erik@montnemery.com>
Date: Thu, 20 Jul 2023 13:34:24 +0200
Subject: [PATCH] Update bind_hass docstring to discourage its use (#96933)

---
 homeassistant/loader.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/homeassistant/loader.py b/homeassistant/loader.py
index 6a8131d2454..6c083b6a024 100644
--- a/homeassistant/loader.py
+++ b/homeassistant/loader.py
@@ -1098,7 +1098,11 @@ class Helpers:
 
 
 def bind_hass(func: _CallableT) -> _CallableT:
-    """Decorate function to indicate that first argument is hass."""
+    """Decorate function to indicate that first argument is hass.
+
+    The use of this decorator is discouraged, and it should not be used
+    for new functions.
+    """
     setattr(func, "__bind_hass", True)
     return func