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.
 
-![xos-containers](./static/xos_containers.png)
\ No newline at end of file
+![xos-containers](./static/xos_containers.png)