Removed index files from all doc directories, rearranged headings, fixed broken links and doc formatting issues, created platform overview file, edited content.brahmaputra.1.0

Change-Id: I08113c732dc6bc5967fe263aecfa8734e4c98ee5
Signed-off-by: Trevor Cooper <trevor.cooper@intel.com>

1 files changed, 27 insertions, 44 deletions

diff --git a/docs/specification/networkconfig.rst b/docs/specification/networkconfig.rst
index af09e564..94477fc7 100644
--- a/docs/specification/networkconfig.rst
+++ b/docs/specification/networkconfig.rst
@@ -6,70 +6,53 @@
 Networking
 ----------
 
-Test-bed network
+**Network Hardware**
 
-* 24 or 48 Port TOR Switch
-* NICS - 1GE, 10GE - per server can be on-board or PCI-e
-* Connectivity for each data/control network is through a separate NIC.
-  *This simplifies Switch Management howeverrequires more NICs on the server and also more switch ports
-* Lights-out network can share with Admin/Management
+  * 24 or 48 Port TOR Switch
+  * NICs - Combination of 1GE and 10GE based on network topology options (per server can be on-board or use PCI-e)
+  * Connectivity for each data/control network is through a separate NIC. This simplifies Switch Management however requires more NICs on the server and also more switch ports
+  * BMC (Baseboard Management Controller) for lights-out mangement network using IPMI (Intelligent Platform Management Interface)
 
-Network Interfaces
+**Network Options**
 
-* Option I: 4x1G Control, 2x40G Data, 48 Port Switch
+  * Option I: 4x1G Control, 2x10G Data, 48 Port Switch
 
-  * 1 x 1G for ILMI (Lights out Management )
-  * 1 x 1G for Admin/PXE boot
-  * 1 x 1G for control Plane connectivity
-  * 1 x 1G for storage
-  * 2 x 40G (or 10G) for data network (redundancy, NIC bonding, High bandwidth testing)
+    * 1 x 1G for lights-out Management
+    * 1 x 1G for Admin/PXE boot
+    * 1 x 1G for control-plane connectivity
+    * 1 x 1G for storage
+    * 2 x 10G for data network (redundancy, NIC bonding, High bandwidth testing)
 
-* Option II: 1x1G Control, 2x 40G (or 10G) Data, 24 Port Switch
+  * Option II: 1x1G Control, 2x 10G Data, 24 Port Switch
 
-  * Connectivity to networks is through VLANs on the Control NIC.
+    * Connectivity to networks is through VLANs on the Control NIC
     * Data NIC used for VNF traffic and storage traffic segmented through VLANs
 
-* Option III: 2x1G Control, 2x10G Data, 2x40G Storage, 24 Port Switch
+  * Option III: 2x1G Control, 2x10G Data, 2x10G Storage, 24 Port Switch
 
-  * Data NIC used for VNF traffic
+    * Data NIC used for VNF traffic
     * Storage NIC used for control plane and Storage segmented through VLANs (separate host traffic from VNF)
-  * 1 x 1G for IPMI
-  * 1 x 1G for Admin/PXE boot
-  * 2 x 10G for control plane connectivity/Storage
-  * 2 x 40G (or 10G) for data network
+    * 1 x 1G for lights-out mangement
+    * 1 x 1G for Admin/PXE boot
+    * 2 x 10G for control-plane connectivity/storage
+    * 2 x 10G for data network
 
 Documented configuration to include:
-- Subnet, VLANs (may be constrained by existing lab setups or rules)
-- IPs
-- Types of NW - lights-out, public, private, admin, storage
-- May be special NW requirements for performance related projects
-- Default gateways
 
-Controller node bridge topology overview
+ - Subnet, VLANs (may be constrained by existing lab setups or rules)
+ - IPs
+ - Types of NW - lights-out, public, private, admin, storage
+ - May be special NW requirements for performance related projects
+ - Default gateways
 
-.. image:: ../images/bridge1.png
-
-compute node bridge topology overview
+**Sample Network Drawings**
 
 .. image:: ../images/bridge2.png
 
-**Network Diagram**
-
-The Pharos architecture may be described as follow:
-Figure 1: Standard Deployment Environment
-
 .. image:: ../images/opnfv-pharos-diagram-v01.jpg
 
-Figure 1: Standard Deployment Environment
-
-**Sample Network Drawings**
-
-Files for documenting lab network layout.
-These were contributed as Visio VSDX format compressed as a ZIP
-file. Here is a sample of what the visio looks like.
+.. image:: ../images/opnfv-example-lab-diagram.png
 
 Download the visio zip file here:
 `opnfv-example-lab-diagram.vsdx.zip
 <https://wiki.opnfv.org/_media/opnfv-example-lab-diagram.vsdx.zip>`_
-
-.. image:: ../images/opnfv-example-lab-diagram.png