docs(tutorial): port the ASGI tutorial

.github/workflows/tests.yaml

@@ -32,6 +32,7 @@ jobs:
           - "py38_smoke_cython"
           - "docs"
           - "look"
+          - "asgilook"
           - "check_vendored"
           - "twine_check"
           - "daphne"

.gitignore

@@ -36,6 +36,9 @@ pip-log.txt
 htmlcov
 nosetests.xml
 
+# ASGI tutorial
+!examples/asgilook/.coveragerc
+
 # Docs
 docs/_build
 dash

docs/user/faq.rst

@@ -262,6 +262,8 @@ same resource class:
     app.add_route('/resources/{id}', resource)
     app.add_route('/resources', resource, suffix='collection')
 
+.. _recommended-route-layout:
+
 What is the recommended way to map related routes to resource classes?
 ----------------------------------------------------------------------
 
@@ -908,6 +910,8 @@ Furthermore, the HTTP2 standard also mandates that header field names MUST be
 converted to lowercase (see `RFC 7540, Section 8.1.2
 <https://httpwg.org/specs/rfc7540.html#rfc.section.8.1.2>`_).
 
+.. _faq_static_files:
+
 Can Falcon serve static files?
 ------------------------------
 
@@ -971,6 +975,8 @@ use cases that may not be supported by your client library, simply encapsulate
 the client library within a management class that handles all the tricky bits,
 and pass that around instead.
 
+.. _configuration-approaches:
+
 What is the recommended approach for making configuration variables available to multiple resource classes?
 -----------------------------------------------------------------------------------------------------------
 

docs/user/index.rst

@@ -8,5 +8,6 @@ User Guide
    install
    quickstart
    tutorial
+   tutorial-asgi
    recipes/index
    faq