provide a little context
Change-Id: I8572cd269edc872dc9fca2908c271333e7390553
diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
index d8aeced..d7af001 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)