expand on guide

README.md

@@ -175,25 +175,43 @@ representation.
 
 ### API Tour
 
-TODO: Go over the general types of default routes)
-
 - All routes prefixed with a `_` are operations routes. These are provided by glngn server.
 - `/_ops/`
     - Deployment `_ops` routes
     - These are always available
-- `/_ops/groups`
-    - query and modify the available groups.
+    - EG: `/_ops/groups`: query and modify the available groups.
 - `/$GROUP/_ops`
     - Group `_ops` routes, `/$GROUP/_ops`, require a group to be created
 - `/$GROUP/$SERVICE/_ops`
     - Service fragment `_ops` routes, `/$GROUP/$SERVICE/_ops`, require the service fragment to be
     instantiated under the group.
     - automatically generated for each instantiated service fragment
+- `/$GROUP/$SERVICE/...`
+    - All other routes under a service are provided by a Service Fragment's `endpoints`.
 
-### Groups
+### Create a Groups
 
-TODO: show dynamic instantiation of a group
+The `/_ops/groups` endpoint is used to query the existing groups and create new groups.
+All services are namespaced under a group. Before we can instantiate and use a service we must
+first create a group:
 
-### Service Fragments
+### Instantiate a Service Fragment
 
 TODO: show dynamic instantiation of a service fragment under a group
+
+### Use a Service Fragment
+
+TODO:
+
+1. show dynamic instantiation of a service fragment in OpenAPI schema.
+2. demo using the counter service fragment
+
+### Capturing Events
+
+TODO:
+
+1. demo capturing unmodeled events:
+    1. deployment-wide (?)
+    2. group events
+    3. service events
+2. demo capturing a service modeled event