diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
index e6aa234..3ab63a9 100644
--- a/docs/SUMMARY.md
+++ b/docs/SUMMARY.md
@@ -18,7 +18,8 @@
 #    * [ELK Stack Logs](operate/elk_stack.md)
     * [REST API](rest_apis.md)
     * [TOSCA](xos-tosca/README.md)
-        * [Development Environment](xos-tosca/devel.md)
+# Not targeted at operators; about internal development
+#        * [Development Environment](xos-tosca/devel.md)
 * [Defining Models in CORD](xos/README.md)
     * [XOS Support for Models](xos/dev/xproto.md)
     * [Core Models](xos/core_models.md)
diff --git a/docs/rest_apis.md b/docs/rest_apis.md
index 69c16ed..fd98261 100644
--- a/docs/rest_apis.md
+++ b/docs/rest_apis.md
@@ -1,15 +1,17 @@
-# CORD REST APIs
+# REST API
 
-## XOS
+A RESTful interface is available for configuring and controlling CORD. It is 
+auto-generated from the set of [models](xos/README.md) configured 
+into the POD manifest, and includes both core and service-specific models.
 
 * [Core](https://guide.opencord.org/{{ book.branch }}/api/xos/#/core)
-* [Address Manager](https://guide.opencord.org/{{ book.branch }}/api/xos/#/addressmanager)
+* [AddressManager](https://guide.opencord.org/{{ book.branch }}/api/xos/#/addressmanager)
 * [vTR](https://guide.opencord.org/{{ book.branch }}/api/xos/#/vtr)
 * [vSG](https://guide.opencord.org/{{ book.branch }}/api/xos/#/vsg)
 * [vNoD Local](https://guide.opencord.org/{{ book.branch }}/api/xos/#/vnodlocal)
 * [vRouter](https://guide.opencord.org/{{ book.branch }}/api/xos/#/vrouter)
-* [ONOS Service](https://guide.opencord.org/{{ book.branch }}/api/xos/#/onos)
-* [Fabric Service](https://guide.opencord.org/{{ book.branch }}/api/xos/#/fabric)
-* [Example Service](https://guide.opencord.org/{{ book.branch }}/api/xos/#/exampleservice)
+* [ONOS](https://guide.opencord.org/{{ book.branch }}/api/xos/#/onos)
+* [Fabric](https://guide.opencord.org/{{ book.branch }}/api/xos/#/fabric)
+* [ExampleService](https://guide.opencord.org/{{ book.branch }}/api/xos/#/exampleservice)
 * [vEE](https://guide.opencord.org/{{ book.branch }}/api/xos/#/vee)
 * [vEG](https://guide.opencord.org/{{ book.branch }}/api/xos/#/veg)