reorganized workflows
Change-Id: I7177b700b6acf8d0abfb5a0d219c090bce5f7310
diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md
index 1dfa603..9a60f8c 100644
--- a/docs/SUMMARY.md
+++ b/docs/SUMMARY.md
@@ -33,10 +33,14 @@
* [Implementation Details](xos/dev/sync_impl.md)
* [Developing for CORD](develop.md)
* [Getting the Source Code](getting_the_code.md)
- * [Workflow: Mock/Single Scenario](xos/dev/workflow_mock_single.md)
- * [Workflow: Local Scenario](xos/dev/workflow_local.md)
- * [Workflow: CiaB Scenario](xos/dev/workflow_pod.md)
- * [Experimental Workflow: K8S Virtual Scenario](controlkube_scenario.md)
+ * [Example Workflows](workflows.md)
+ * [Mock/Single Scenario](xos/dev/workflow_mock_single.md)
+ * [Local Scenario (Models, GUI)](xos/dev/workflow_local.md)
+ * [Local Scenario (Synchronizers)](xos/tutorials/local_synchronizer_dev_loop.md)
+ * [CiaB Scenario](xos/dev/workflow_pod.md)
+ * [Experimental: K8S Virtual Scenario](controlkube_scenario.md)
+ * [Example Service](xos/tutorials/example_service.md)
+ * [VTN and Service Composition](xos/xos_vtn.md)
* [TOSCA Development](platform-install/bootstrap_models_in_xos.md)
* [GUI Development](xos-gui/developer/README.md)
* [Quickstart](xos-gui/developer/quickstart.md)
@@ -46,10 +50,6 @@
* [Module Strucure](xos-gui/architecture/gui-modules.md)
* [Data Sources](xos-gui/architecture/data-sources.md)
* [Tests](xos-gui/developer/tests.md)
- * [VTN and Service Composition](xos/xos_vtn.md)
- * [Tutorials](xos/tutorials/tutorials.md)
- * [Example Service](xos/tutorials/example_service.md)
- * [Synchronizer in the Local Scenario](xos/tutorials/local_synchronizer_dev_loop.md)
* [Unit Tests](xos/dev/unittest.md)
* [Testing CORD](cord-tester/README.md)
* [Test Setup](cord-tester/qa_testsetup.md)
diff --git a/docs/develop.md b/docs/develop.md
index 779a71b..402fa27 100644
--- a/docs/develop.md
+++ b/docs/develop.md
@@ -1,9 +1,6 @@
# Developing for CORD
-This guide describes how to develop for CORD. It includes two example
-workflows, one based on a lightweight development environment that runs on a
-laptop and a more realistic environment that runs an emulated version of a CORD
-POD. It also documents the key elements involved in developing services that
-can be on-boarded into CORD.
-
-
+This guide describes how to develop for CORD. It includes several example
+developer workflows, a tour of an example service, an overview of how
+services are interconnected in the data plane, and in-depth
+descriptions of how to develop/extend the TOSCA and GUI interfaces.
diff --git a/docs/workflows.md b/docs/workflows.md
new file mode 100644
index 0000000..1424eb3
--- /dev/null
+++ b/docs/workflows.md
@@ -0,0 +1,5 @@
+# Example Workflows
+
+The following sections document several developer workflows, some
+tailored for developing the core platform, some for developing isolated
+services, and some for developing end-to-end service chains.