Added quick start

In addition
- Added supported topology diagrams
- Updated quick start with Stratum tutorial
- Fixed a link error

Change-Id: I1db3f81b406dc991db191ccdfed2b30bb570d6bc
diff --git a/development.rst b/development.rst
new file mode 100644
index 0000000..6ffe401
--- /dev/null
+++ b/development.rst
@@ -0,0 +1,6 @@
+Development Guide
+*****************
+
+.. note::
+	We are updating the content of this page. More coming soon.
+
diff --git a/images/install-2x2.png b/images/install-2x2.png
new file mode 100644
index 0000000..b0ab373
--- /dev/null
+++ b/images/install-2x2.png
Binary files differ
diff --git a/images/install-2x4.png b/images/install-2x4.png
new file mode 100644
index 0000000..2d4d8e0
--- /dev/null
+++ b/images/install-2x4.png
Binary files differ
diff --git a/images/install-full.png b/images/install-full.png
new file mode 100644
index 0000000..3a704c1
--- /dev/null
+++ b/images/install-full.png
Binary files differ
diff --git a/images/install-pair.png b/images/install-pair.png
new file mode 100644
index 0000000..99c091e
--- /dev/null
+++ b/images/install-pair.png
Binary files differ
diff --git a/images/install-single.png b/images/install-single.png
new file mode 100644
index 0000000..2a0d772
--- /dev/null
+++ b/images/install-single.png
Binary files differ
diff --git a/index.rst b/index.rst
index becaf30..2c669ab 100644
--- a/index.rst
+++ b/index.rst
@@ -71,6 +71,14 @@
     .. image:: images/index-usecase-chassis.png
        :width: 600px
 
+Get Started
+===========
+- Read the `Quick Start <quickstart.html>`_ guide and get some hands on experiences.
+- Stay in touch by joining
+
+  - `Trellis Developer Mailing List <https://groups.google.com/a/opennetworking.org/forum/#!forum/trellis-dev>`_
+  - \#trellis channel in `ONOS Slack <https://onosproject.slack.com>`_ (`register <https://slackin.onosproject.org/>`_)
+
 .. toctree::
    :maxdepth: 1
    :hidden:
@@ -79,8 +87,11 @@
    architecture
    specification
    supported-hardware
+   supported-topology
+   quickstart
    installation
    configuration
    troubleshooting
+   development
    testing
    readme
diff --git a/installation.rst b/installation.rst
index 2bfe5ce..2ebea50 100644
--- a/installation.rst
+++ b/installation.rst
@@ -3,32 +3,6 @@
 Installation Guide
 ******************
 
-Topology
-========
-Trellis supports various topology, from a single switch to a full multi-stage leaf-spine fabric.
-
-- **Single switch**: This is the minimum Trellis setup. In this setup, all servers are connected to a single switch.
-- **Paired switches**: Compared to single switch, it provides more redundancy in terms of server NIC failure and link failure.
-- **Single-stage leaf-spine**: Compared to single switch, it offers more redundancy in terms of switch failure and provides better scalability.
-- **Single-stage leaf-spine with paired switches**: It supports all the redundancy and scalability features mentioned above.
-- **Multi-stage leaf-spine**: Multi-stage is specifically designed for telco service providers.
-  The first stage can be installed in the central office, while the second stage can be installed in a field office that is closer to the subscribers.
-  Two stages are typically connected via long distance optical transport.
-
-
-Trellis in a Box (TiaB)
-=======================
-TiaB is a software emulated environment that allows people to run Trellis without hardware switches.
-TiaB comes with a few Mininet scripts that emulate network topology from a simple 2x2 leaf-spine to a full multi-stage fabric.
-The configurations corresponding to each topology are also packaged together such that you can start the environment right away.
-
-TiaB is currently hosted in a GitHub repository separated from ONOS.
-The source code and user guide of TiaB can be found `here <https://github.com/opennetworkinglab/routing/tree/master/trellis>`_.
-
-.. tip::
-    TiaB is the most convenient and **recommended option for beginners who would like to quickly get some hands on experience** of Trellis.
-
-
 Building a Hardware Pod
 =======================
 See :doc:`Supported Hardware <supported-hardware>` for details.
diff --git a/quickstart.rst b/quickstart.rst
new file mode 100644
index 0000000..77938a0
--- /dev/null
+++ b/quickstart.rst
@@ -0,0 +1,19 @@
+Quick Start
+***********
+
+Trellis in a Box
+----------------
+`Trellis in a Box (TiaB) <https://github.com/opennetworkinglab/routing/tree/master/trellis>`_ is a software emulated environment that allows people to run Trellis without hardware switches.
+TiaB comes with a few Mininet scripts that emulate various network topologies from a **simple 2x2 leaf-spine** to a **full multi-stage** fabric.
+The configurations corresponding to each topology are also packaged together such that you can start the environment right away.
+
+Currently TiaB only emulates the data plane, meaning that you will have to run ONOS separately.
+We plan to integrate the control plane (ONOS) in the future.
+
+
+Trellis with Stratum
+--------------------
+There is another tutorial of `How to Use Trellis with Stratum Switches <https://github.com/stratum/stratum/tree/master/tools/mininet/examples/trellis>`_.
+This is also a software emulated environment similar to TiaB. But unlike TiaB, this tutorial uses ``stratum-bmv2`` to emulate the data plane switches instead of ``ovs``.
+
+This tutorial focuses more on Trellis and Stratum integration and therefore only demonstrates a **simple 2x2 leaf-spine** topology.
diff --git a/specification.rst b/specification.rst
index 8e86b5a..2d92d43 100644
--- a/specification.rst
+++ b/specification.rst
@@ -127,7 +127,7 @@
     - Broadcom Tomahawk, Trident2, Qumran
     - Barefoot Tofino
   - 1/10G, 25G, 40G to 100G
-  - Refer to docs.trellisfabric.org/supported-hardware.html for the most up-to-date hardware list
+  - Refer to :doc:`Supported Hardware <supported-hardware>` for the most up-to-date hardware list
 
 Whitebox Switch Software
 ========================
diff --git a/supported-topology.rst b/supported-topology.rst
new file mode 100644
index 0000000..c7632ab
--- /dev/null
+++ b/supported-topology.rst
@@ -0,0 +1,42 @@
+Supported Topology
+******************
+
+Trellis supports various topologies, from a single switch to a full multi-stage leaf-spine fabric.
+
+Simple
+======
+
+Single switch
+-------------
+This is the minimum Trellis setup. In this setup, all servers are connected to a single switch.
+
+    .. image:: images/install-single.png
+
+Paired switches
+---------------
+Compared to single switch, it provides more redundancy in terms of server NIC failure and link failure.
+
+    .. image:: images/install-pair.png
+
+Single-Stage Leaf-Spine
+=======================
+
+Without paired switches
+-----------------------
+Compared to single switch, it offers more redundancy in terms of switch failure and provides better scalability.
+
+    .. image:: images/install-2x2.png
+
+With paired switches
+--------------------
+It supports all the redundancy and scalability features mentioned above.
+
+    .. image:: images/install-2x4.png
+
+Multi-Stage Leaf-Spine
+======================
+Multi-stage is specifically designed for telco service providers.
+The first stage can be installed in the central office, while the second stage can be installed in a field office that is closer to the subscribers.
+Two stages are typically connected via long distance optical transport.
+
+    .. image:: images/install-full.png
\ No newline at end of file