docs(FAQ): add a note that wsgiref.simple_server is not recommended f…

…or prod
falconry · Jan 15, 2024 · 861fa3b · 861fa3b
1 parent 3375063
commit 861fa3b
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/docs/user/faq.rst b/docs/user/faq.rst
@@ -1277,6 +1277,11 @@ thread (otherwise it may deadlock):
         print('Serving on port 8000, POST to /shutdown to stop...')
         httpd.serve_forever()
 
+.. warning::
+   While ``wsgiref.simple_server`` is handy for integration testing, it builds
+   upon :mod:`http.server`, which is not recommended for production. (See
+   :ref:`install` on how to install a production-ready WSGI or ASGI server.)
+
 How can I set cookies when simulating requests?
 -----------------------------------------------