Update Sphinx version and versioning process
- Updated to newer Sphinx version
- Changed to use doc8 to check .rst files
- Added a dictionary (dict.txt) and spellchecking
- Reformatted and fixed issues that were found in the content
Change-Id: If7b35e01ee8be25dbbd1ecd0e67b264aa6cc2a94
diff --git a/quickstart.rst b/quickstart.rst
index 77938a0..a7fd97c 100644
--- a/quickstart.rst
+++ b/quickstart.rst
@@ -3,17 +3,31 @@
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.
+`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.
-Currently TiaB only emulates the data plane, meaning that you will have to run ONOS separately.
+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.
+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.