diff --git a/docs/dev/workflow_local.md b/docs/dev/workflow_local.md
new file mode 100644
index 0000000..28952c4
--- /dev/null
+++ b/docs/dev/workflow_local.md
@@ -0,0 +1,53 @@
+# Local Workflow
+
+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
+about the different POD config files, please refer to [Building and Installing
+CORD](/install.md#included-scenarios).
+
+The `local` scenario is suitable for working on (and verifying the correctness
+of):
+
+- `core` models
+- `service` models
+- `gui`
+
+It runs in a set of local docker containers, and is the most lightweight of all
+CORD development environments.
+
+## Requirements
+
+The following assumes you have cloned the source code as described in: [Getting
+the Source Code](/getting_the_code.md). 
+
+To deploy a `local` scenario on your machine, you'll also need to install
+[Docker](https://www.docker.com/community-edition).
+
+These steps may be able to be automated by running the [cord-bootstrap.sh
+script](/install.md#cord-bootstrapsh-script), with the `-d` option.
+
+## Initial Deployment
+
+You can setup a `local` POD config on your machine as follows.
+
+```
+cd ~/cord/build
+make PODCONFIG=rcord-local.yml config
+make -j4 build
+```
+
+After the build completes, the XOS web GUI will be available at
+`localhost:8080/xos`
+
+
+### Destroy and Rebuild XOS
+
+This is the workflow that you'll need to follow if you want to start from a
+fresh XOS installation. Note that it wipes the out the XOS database.
+
+```
+cd ~/cord/build
+make xos-teardown
+make -j4 build
+```
+
diff --git a/docs/dev/workflow_pod.md b/docs/dev/workflow_pod.md
index e94474d..fe4bafb 100644
--- a/docs/dev/workflow_pod.md
+++ b/docs/dev/workflow_pod.md
@@ -24,29 +24,29 @@
 2. Teardown the existing XOS installation and clean up OpenStack to
    remove any leftover instances or networks:
 
-```
-cd ~/cord/build
-make xos-teardown
-make clean-openstack
-```
+    ```
+    cd ~/cord/build
+    make xos-teardown
+    make clean-openstack
+    ```
 
 3. Optional: Teardown ONOS. Sometimes we find it helpful to reinstall the
    onos-cord and onos-fabric containers, to ensure that all state is wiped
    clean from ONOS.
 
-```
-cd ~/cord/build
-make clean-onos
-```
+    ```
+    cd ~/cord/build
+    make clean-onos
+    ```
 
 4. Build the new XOS container images and deploy to the pod.
 
-```
-cd ~/cord/build
-make -j4 build
-make compute-node-refresh
-make pod-test
-```
+    ```
+    cd ~/cord/build
+    make -j4 build
+    make compute-node-refresh
+    make pod-test
+    ```
 
 5. Test and verify your changes.