From b0322d56a805229caed25a4348ab3799cb80ad80 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=8B=A5=E5=8F=AF?=
 <45256779+YorkSu@users.noreply.github.com>
Date: Fri, 31 Jan 2025 01:27:06 +0800
Subject: [PATCH] docs: gunicorn with uvicorn workers (#3973)

---
 docs/topics/deployment/manually-with-asgi-server.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/topics/deployment/manually-with-asgi-server.rst b/docs/topics/deployment/manually-with-asgi-server.rst
index 61436016d1..f2bc614769 100644
--- a/docs/topics/deployment/manually-with-asgi-server.rst
+++ b/docs/topics/deployment/manually-with-asgi-server.rst
@@ -160,3 +160,14 @@ ASGI server with the following command:
 
             [INFO] Starting granian
             [INFO] Listening at: 127.0.0.1:8000
+
+Gunicorn with Uvicorn workers
+-----------------------------
+
+.. important:: **Deprecation Notice**
+
+    The Gunicorn+Uvicorn pattern is considered legacy for ASGI deployments since `Uvicorn 0.30.0+ <https://github.com/encode/uvicorn/releases/tag/0.30.0/>`_ includes native worker management.
+
+    Uvicorn added a new multiprocess manager, that is meant to replace Gunicorn entirely. Refer to the pull request `#2183 <https://github.com/encode/uvicorn/pull/2183/>`_ for implementation details.
+
+    For new deployments, use Uvicorn directly.