Add other services doc

docs/advanced/other-services.rst

@@ -0,0 +1,25 @@
+Serving TwirPHP with other services
+===================================
+
+In some cases you might want to serve not just one, but multiple services from one application.
+The generated code contains a simple server implementation which lets you mux different services.
+
+.. code-block:: php
+
+    $server = new \Twitch\Twirp\Example\Server();
+
+    // register services
+    $server->registerServer(
+        \Twitch\Twirp\Example\HaberdasherServer::PATH_PREFIX,
+        new \Twitch\Twirp\Example\HaberdasherServer(
+            new \Twirphp\Example\Haberdasher()
+        )
+    );
+
+Both the server and service server implement the same ``RequestHandler`` interface, so you can use the same code
+as in the :ref:`run-server` usage example:
+
+.. code-block:: php
+
+    // ...
+    $response = $server->handle($request);

docs/getting-started/best-practices.rst

@@ -15,7 +15,7 @@ There are three types of "resources" to consider in case of a PHP projects using
 
 Following common PHP packaging practice the recommended folder structure is:
 
-.. code-block::
+.. code-block:: text
 
     /generated
         /<namespace>

docs/getting-started/usage.rst

@@ -85,6 +85,8 @@ Now that everything is in place, it's time to implement the server implementing
     }
 
 
+.. _run-server:
+
 Run the server
 --------------
 

docs/index.rst

@@ -31,6 +31,12 @@ resources published by the Twirp developers themselves:
     getting-started/usage
     getting-started/best-practices
 
+.. toctree::
+    :hidden:
+    :caption: Beyond the basics
+
+    advanced/other-services
+
 
 .. _Twirp: https://twitchtv.github.io/twirp/
 .. _protobuf: https://developers.google.com/protocol-buffers/

docs/spelling_word_list.txt

@@ -14,3 +14,4 @@ Quickstart
 quickstart
 metapackage
 entrypoint
+proto