docs(ws-tutorial): add a WebSocket tutorial

.github/workflows/tests.yaml

@@ -35,6 +35,7 @@ jobs:
           - "towncrier"
           - "look"
           - "asgilook"
+          - "wslook"
           - "check_vendored"
           - "twine_check"
           - "daphne"

docs/api/websocket.rst

@@ -424,6 +424,10 @@ by the framework.
     app = falcon.asgi.App(middleware=SomeMiddleware())
     app.add_route('/{account_id}/messages', SomeResource())
 
+.. tip::
+   If you prefer to learn by doing, feel free to continue experimenting along
+   the lines of our :ref:`WebSocket tutorial <tutorial-ws>`!
+
 Testing
 -------
 

docs/user/index.rst

@@ -9,5 +9,6 @@ User Guide
    quickstart
    tutorial
    tutorial-asgi
+   tutorial-websockets
    recipes/index
    faq

docs/user/tutorial-asgi.rst

@@ -1033,6 +1033,10 @@ numerous ways:
   :ref:`WebSockets <ws>`.
 * ...And much more (patches welcome, as they say)!
 
+.. tip::
+   If you want to add :ref:`WebSocket <ws>` support, please check out our
+   :ref:`WebSocket tutorial <tutorial-ws>` too!
+
 Compared to the sync version, asynchronous code can at times be harder to
 design and reason about. Should you run into any issues, our friendly community
 is available to answer your questions and help you work through any sticky