Fix 606 Webserver documentation does not describe services (#608)

* Fix 606 Webserver documentation does not describe services

docs/src/main/docs/webserver/03_routing.adoc

@@ -110,3 +110,31 @@ requests accepted by the predicate. All other requests are _nexted_, meaning tha
                       })
                       .otherwise((req, resp) -> { /* Otherwise logic */ }); // Optional. Default logic is req.next()
 ----
+
+== Organizing Code into Services
+
+By implementing the `Service` interface you can organize your code into one
+or more services, each with its own path prefix and set of handlers.
+
+[source,java]
+.Use `Routing.Builder.register` to register your service
+----
+.register("/hello", new HelloService())
+----
+
+[source,java]
+.Service implementation
+----
+public class HelloService implements Service {
+    @Override
+    public void update(Routing.Rules rules) {
+        rules.get("/subpath", this::getHandler);
+    }
+
+    private void getHandler(ServerRequest request,
+                            ServerResponse response) {
+        // Some logic
+    }
+}
+----
+In this example, the `GET` handler matches requests to `/hello/subpath`.

docs/src/main/docs/webserver/05_error-handling.adoc

@@ -1,6 +1,6 @@
 ///////////////////////////////////////////////////////////////////////////////
 
-    Copyright (c) 2018 Oracle and/or its affiliates. All rights reserved.
+    Copyright (c) 2018, 2019 Oracle and/or its affiliates. All rights reserved.
 
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.
@@ -97,23 +97,3 @@ exception called `req.next()`, then the exception is translated to an HTTP respo
  error code `500`.
 
 
-== Registering an application - Organizing code into services
-
-You can also register an application that has its own handlers at a path prefix or context root.
-[source,java]
-.Registering routing logic for a context root
-----
-.register("/context-root", new MyComplexApplication())
-----
-
-[source,java]
-.Routing logic implementation
-----
-public class MyComplexApplication implements Consumer<Routing.Config> {
-    @Override
-    public void accept(Routing.Config config) {
-        config.get("/subpath", (req, res) -> {/* handler */});
-    }
-}
-----
-In this example, the `GET` handler matches requests to `/context-root/subpath`.