python-websockets
diff --git a/‎docs/conf.py‎
Lines changed: 5 additions & 1 deletion b/‎docs/conf.py‎
Lines changed: 5 additions & 1 deletion
diff --git a/‎docs/howto/heroku.rst‎
Lines changed: 3 additions & 1 deletion b/‎docs/howto/heroku.rst‎
Lines changed: 3 additions & 1 deletion
diff --git a/‎docs/intro/index.rst‎
Lines changed: 19 additions & 4 deletions b/‎docs/intro/index.rst‎
Lines changed: 19 additions & 4 deletions
@@ -95,7 +95,11 @@
 code_url = f"https://github.com/aaugustin/websockets/blob/{commit}"
 
 def linkcode_resolve(domain, info):
-    assert domain == "py"
+    # Non-linkable objects from the starter kit in the tutorial.
+    if domain == "js" or info["module"] == "connect4":
+        return
+
+    assert domain == "py", "expected only Python objects"
 
     mod = importlib.import_module(info["module"])
     if "." in info["fullname"]:
 
@@ -42,6 +42,7 @@ Here's the implementation of the app, an echo server. Save it in a file called
 ``app.py``:
 
 .. literalinclude:: ../../example/deployment/heroku/app.py
+    :language: text
 
 Heroku expects the server to `listen on a specific port`_, which is provided
 in the ``$PORT`` environment variable. The app reads it and passes it to
@@ -62,6 +63,7 @@ In order to build the app, Heroku needs to know that it depends on websockets.
 Create a ``requirements.txt`` file containing this line:
 
 .. literalinclude:: ../../example/deployment/heroku/requirements.txt
+    :language: text
 
 Heroku also needs to know how to run the app. Create a ``Procfile`` with this
 content:
@@ -86,7 +88,7 @@ The app is ready. Let's deploy it!
 
 .. code-block:: console
 
-    $ git push heroku main
+    $ git push heroku
 
     ... lots of output...
 
 
@@ -16,19 +16,34 @@ websockets requires Python ≥ 3.7.
 
 It doesn't have any dependencies.
 
+.. _install:
+
 Installation
 ------------
 
-Install websockets with::
+Install websockets with:
+
+.. code-block:: console
 
-    pip install websockets
+    $ pip install websockets
 
 Wheels are available for all platforms.
 
-First steps
+Tutorial
+--------
+
+Learn how to build an real-time web application with websockets.
+
+.. toctree::
+
+    tutorial1
+    tutorial2
+    tutorial3
+
+In a hurry?
 -----------
 
-If you're in a hurry, check out these examples.
+Check out these examples.
 
 .. toctree::