commit 5e0c8e0f23794b207de37ed4861015521bb224ea
author llp <llp@onlab.us> Mon Sep 18 10:07:35 2017 -0700
committer Larry Peterson <llp@opennetworking.org> Mon Sep 18 16:26:23 2017 -0700
tree 6aa97d95446c13a19f1d66f48675785488e8d112
parent fd40a1238a8c67ceaca713a811baa904267c09b7

provide a little context

Change-Id: I8572cd269edc872dc9fca2908c271333e7390553
(cherry picked from commit ec723ad8b6b77cf1caa5aaaef67410f5c1670350)

docs/SUMMARY.md

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)

docs/rest_apis.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)