diff --git a/doc/install-guide/bk_openstackinstallguide.xml b/doc/install-guide/bk_openstackinstallguide.xml
index 83fe2690ba..53f06b173b 100644
--- a/doc/install-guide/bk_openstackinstallguide.xml
+++ b/doc/install-guide/bk_openstackinstallguide.xml
@@ -189,10 +189,10 @@
+
-
diff --git a/doc/install-guide/ch_networking.xml b/doc/install-guide/ch_networking.xml
new file mode 100644
index 0000000000..e53b5437d3
--- /dev/null
+++ b/doc/install-guide/ch_networking.xml
@@ -0,0 +1,32 @@
+
+
+ Add a networking service
+
+
+ We are updating this material for Icehouse. You may find structure
+ and/or content issues during this process.
+
+
+ Networking (neutron)
+
+
+
+
+
+
+
+ Legacy networking
+
+
+
diff --git a/doc/install-guide/ch_nova.xml b/doc/install-guide/ch_nova.xml
index 037a7023bf..95f33d8185 100644
--- a/doc/install-guide/ch_nova.xml
+++ b/doc/install-guide/ch_nova.xml
@@ -9,6 +9,6 @@
-
+
diff --git a/doc/install-guide/ch_overview.xml b/doc/install-guide/ch_overview.xml
index dbacaba753..ba20ff3a7b 100644
--- a/doc/install-guide/ch_overview.xml
+++ b/doc/install-guide/ch_overview.xml
@@ -83,7 +83,8 @@
When you implement this architecture, skip
- . To use optional services, you
+ in
+ . To use optional services, you
might need to install additional nodes, as described in
subsequent chapters.
@@ -134,9 +135,10 @@
When you implement this architecture, skip
- in .
- To use optional services, you might need to install additional
- nodes, as described in subsequent chapters.
+ in
+ . To use optional services, you
+ might need to install additional nodes, as described in
+ subsequent chapters.
Three-node architecture with OpenStack Networking (neutron)
diff --git a/doc/install-guide/section_nova-network.xml b/doc/install-guide/section_nova-networking-compute-node.xml
similarity index 93%
rename from doc/install-guide/section_nova-network.xml
rename to doc/install-guide/section_nova-networking-compute-node.xml
index 5a2959173e..7a99c42485 100644
--- a/doc/install-guide/section_nova-network.xml
+++ b/doc/install-guide/section_nova-networking-compute-node.xml
@@ -17,19 +17,6 @@
functionality across multiple hosts. As a result, no single
network controller acts as a single point of failure. This process
configures each compute node for networking.
-
- Choose one of these options to configure networking in OpenStack:
-
-
- Legacy networking in OpenStack Compute, which is
- described here.
-
-
- The full software-defined networking stack. See .
-
-
- Install the appropriate packages for compute networking on the