wordsmithing overview pages
Change-Id: I295561504b268a71c1d8394521e391f6d19c5b53
diff --git a/navigate.md b/navigate.md
index 7e3479e..f307986 100644
--- a/navigate.md
+++ b/navigate.md
@@ -1,10 +1,10 @@
# Navigating CORD
-## Assembled in Layers
+## Assembled from Components
-A given instance of CORD is constructed from a set of disaggregated
+A given instance of CORD is assembled from a set of disaggregated
components. This assembly is done according to the general pattern
-shown in the following conceptual diagram.
+shown in the following diagram.
@@ -12,11 +12,13 @@
* **Kubernetes:** All elements of the CORD control plane run in
Kubernetes containers. CORD assumes a Kubernetes foundation,
- but does not prescribe how the hardware or Kubernetes are installed.
+ but does not prescribe how Kubernetes (or the underlying hardware)
+ are installed.
* **Platform:** The Platform layer consists of ONOS, XOS,
Kafka, and collection of Logging and Monitoring micro-services,
- all running on a Kubernetes foundation.
+ all running on a Kubernetes foundation. The platform is common
+ to all Profiles.
* **Profile:** Each unique CORD configuration corresponds to a
Profile. It consists of a set of services (e.g., access services,
@@ -27,8 +29,8 @@
* **Workflow:** A Profile includes one or more workflows, each of
which defines the business logic and state machine for one of the
- access technologies. A workflow augments/parameterizes a Profile for
- the target deployment environment; it is not a layer, per se. SEBA's
+ access technologies. A workflow customizes a Profile for the target
+ deployment environment; it is not a layer, per se. SEBA's
[AT&T Workflow](profiles/seba/workflows/att-install.md) is an example.
The diagram also shows a hardware bill-of-materials, which must be
diff --git a/overview.md b/overview.md
index a67e6db..1a16dfb 100644
--- a/overview.md
+++ b/overview.md
@@ -29,11 +29,11 @@
included in CORD.
These are all fairly obvious. What's less obvious is the relationship among
-these stages, which is helpful in [Navigating CORD](navigate.md).
+these stages, which is explained in [Navigating CORD](navigate.md).
## Navigating the References
-CORD is built from components and the aggregation of components into a
+CORD is built from disaggregated components that are assembled into a
composite solution. The References are organized accordingly:
* [Profile Reference](profiles/intro.md): Installation and
diff --git a/quickstart.md b/quickstart.md
index 3dfab6b..382d310 100644
--- a/quickstart.md
+++ b/quickstart.md
@@ -2,7 +2,7 @@
This section walks you through an example installation sequence on two
different Unix-based platforms. This is just a surface introduction to
-CORD. If you'd prefer to understand the installation process in more
+CORD. If you prefer to understand the installation process in more
depth, including the full range of deployment options, you should
start with the [Installation Guide](README.md) instead.
@@ -16,6 +16,7 @@
* [MacOS](macos.md)
* [Linux](linux.md)
-Instead if you want to quickly get started with a complete CORD system together
-with the CORD platform, a profile such as SEBA, an exemplar operator workflow and
-an emulated data-plane, consider [SEBA-in-a-Box](./profiles/seba/siab-overview.md).
+If you want to quickly get started with a complete CORD system
+running on your laptop—including the CORD platform, the SEBA profile,
+an exemplar operator workflow, and an emulated data-plane—you could
+give [SEBA-in-a-Box](./profiles/seba/siab-overview.md) a try.