general cleanup
Change-Id: I1c82a83dfc4c7a2a3e2063e3030373d9ceaafe5b
diff --git a/docs/dev/workflow_local.md b/docs/dev/workflow_local.md
index a2bb2b4..c515469 100644
--- a/docs/dev/workflow_local.md
+++ b/docs/dev/workflow_local.md
@@ -1,4 +1,4 @@
-# Local Workflow
+# Workflow: Local Scenario
The following describes a workflow for XOS core or GUI development using a
local environment (e.g., a laptop) with the local 'scenario'. To learn more
diff --git a/docs/dev/workflow_mock_single.md b/docs/dev/workflow_mock_single.md
index 7f164a7..9e76192 100644
--- a/docs/dev/workflow_mock_single.md
+++ b/docs/dev/workflow_mock_single.md
@@ -1,4 +1,4 @@
-# Mock/Single Workflow
+# Workflow: Mock/Single Scenario
The following describes a workflow for service or core development using a
local environment (e.g., a laptop) with the `rcord-mock` or `rcord-single`
diff --git a/docs/dev/workflow_pod.md b/docs/dev/workflow_pod.md
index fe4bafb..6b659b8 100644
--- a/docs/dev/workflow_pod.md
+++ b/docs/dev/workflow_pod.md
@@ -1,4 +1,4 @@
-# Virtual POD Workflow
+# Workflow: CiaB Scenario
For service or core development using a [virtual POD
(CiaB)](/install_virtual.md), we have a tighter development workflow loop which
diff --git a/docs/modules/xosconfig.md b/docs/modules/xosconfig.md
index fcfebc4..b908c23 100644
--- a/docs/modules/xosconfig.md
+++ b/docs/modules/xosconfig.md
@@ -1,17 +1,17 @@
-# Configuring XOS
+# XOS Configuration
The `xosconfig` module is used to read, validate and distribute
configuration information for all XOS-related components.
-_The code for this module can be found in lib/xos-config_
+The code for this module can be found in `lib/xos-config`.
The `xosconfig` module uses a combination of parameters provided
via a `.yaml` file and a service discovery mechanism.
## How to Use This Module
-This module needs to be initialized once (and only once) when you
-start the application. You can do it with:
+This module needs to be initialized once (and only once) when XOS
+starts. You can do it with:
```python
from xosconfig import Config
@@ -100,7 +100,7 @@
> curl consul:8500/v1/catalog/services
>```
-#### Retrieve Information for a Single Service
+#### Retrieving Information for a Single Service
Invoking
diff --git a/docs/xos_internals.md b/docs/xos_internals.md
index 6c99e4f..08807d5 100644
--- a/docs/xos_internals.md
+++ b/docs/xos_internals.md
@@ -1,16 +1,9 @@
-# XOS Internal
+# XOS Containers
-XOS, often referred as the CORD orchestrator, is the unique source of truth in a CORD installation.
-Here is an overview of its structure.
-
-> Please note that this page is a work in progress, and help/contribution is really appreciated.
-
-# Containers
-
-XOS is made up of a set of Docker containers that cooperate to provide the platform functionalities,
-from data-model to northbound APIs to synchronizers.
-
-Here is an inventory of those containers:
+XOS is made up of a set of Docker containers that cooperate to provide
+platform controller functionaly, including the data model,
+synchronizers, and northbound APIs. The following is an inventory of
+those containers:
| Name | Description | Ports |
| ---- | ----------- | ----- |
@@ -27,4 +20,4 @@
All the communication between containers happen over `gRPC` except for `xos-gui`
where it is a combination of REST and web-socket.
-
\ No newline at end of file
+