Added local scenario docs and fix numbering on physical workflow
Change-Id: I95362f28460bb75e488993bafcd9b1c3ddf5829b
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.