Added introduction
Change-Id: I06eb14895c6293160879e289c19902784bf66279
diff --git a/conf.py b/conf.py
index 6e16d1e..6dae38e 100644
--- a/conf.py
+++ b/conf.py
@@ -101,6 +101,11 @@
# The name of the Pygments (syntax highlighting) style to use.
pygments_style = None
+# Ignore link check for the following websites
+linkcheck_ignore = [
+ 'https://www.opennetworking.org/trellis/',
+]
+
# -- Options for HTML output -------------------------------------------------
# The theme to use for HTML and HTML Help pages. See the documentation for
diff --git a/images/index-usecase-chassis.png b/images/index-usecase-chassis.png
new file mode 100644
index 0000000..2fb8b76
--- /dev/null
+++ b/images/index-usecase-chassis.png
Binary files differ
diff --git a/images/index-usecase-dc.png b/images/index-usecase-dc.png
new file mode 100644
index 0000000..94fb5e4
--- /dev/null
+++ b/images/index-usecase-dc.png
Binary files differ
diff --git a/images/index-usecase-edge.png b/images/index-usecase-edge.png
new file mode 100644
index 0000000..de27824
--- /dev/null
+++ b/images/index-usecase-edge.png
Binary files differ
diff --git a/images/index-usecase-seba.png b/images/index-usecase-seba.png
new file mode 100644
index 0000000..d211ffa
--- /dev/null
+++ b/images/index-usecase-seba.png
Binary files differ
diff --git a/index.rst b/index.rst
index eda6bf9..8d5e27f 100644
--- a/index.rst
+++ b/index.rst
@@ -1,7 +1,75 @@
Trellis Documentation
*********************
-This documents the Trellis project
+.. image:: images/trellis.png
+ :width: 500px
+ :align: center
+
+Trellis is an **open-source multi-purpose L2/L3 leaf-spine switching fabric**.
+The development of Trellis over the last four years has been influenced by three core trends in the networking industry:
+
+- First, **Trellis is built using bare-metal switches with merchant-silicon ASICs**.
+ Instead of using OEM networking hardware, Trellis uses hardware directly from ODMs.
+ The trend of using bare-metal (white-box) switches is unmistakable in the networking industry today, spurred by the massive bandwidth-density and growing sophistication of merchant silicon ASICs.
+ Production quality Trellis today is based on EdgeCore switches with Broadcom Trident2, Tomahawk and Qumran switch ASICs.
+ The Trellis team continues to work towards including more ODMs and merchant silicon vendors.
+
+- Second, **Trellis is based on SDN principles**, to provide simpler, more flexible and easily customizable networks.
+ By externalizing the network’s control, management functions and policy decisions in the ONOS SDN controller,
+ Trellis provides network operators with a number of SDN benefits compared to traditional box-embedded network control.
+ These include centralized configuration, automation, operation and troubleshooting.
+
+- Third, **Trellis is open-source**.
+ The networking industry has seen an explosion of open source projects, and network operators have been eager to embrace open-source solutions.
+ Trellis allows operators unparalleled ability to customize Trellis for their application, integrate with the rest of their systems,
+ add features and APIs themselves and not be beholden to a traditional vendor’s timelines and prices.
+ An absence of commercial licenses lowers the bar for anyone to try out Trellis.
+
+Together, all three attributes of Trellis considerably lower the Total Cost of Ownership (TCO) for operators who plan to run it in production.
+
+
+Highlights
+==========
+- Classic-SDN Control with ONOS to directly program ASIC forwarding tables in bare metal switches with merchant silicon
+- L2 forwarding (Bridging) within server-racks and L3 forwarding (Routing) across racks
+- MPLS Segment routing for better scale and reduced programming
+- Control plane functionality with Trellis vRouter for external connectivity
+- N-way redundancy and tier-1 telecom operator scale
+- Support for different use cases ranging from Central Office to backhaul in operator networks
+- Single-pane-of-glass monitoring and troubleshooting with ONOS
+- CapEx and OpEx savings with white-box hardware and open source software
+- Future Proof: P4 and Stratum integration to unlock advanced capabilities
+
+
+Use Cases
+=========
+
+Distributed Fabric for Access/Edge Networking
+---------------------------------------------
+
+.. image:: images/index-usecase-edge.png
+ :width: 1000px
+
+Disaggregated BNG in SEBA using P4
+----------------------------------
+
+.. image:: images/index-usecase-seba.png
+ :width: 1000px
+
+Enterprise Datacenter Fabrics
+-----------------------------
+.. image:: images/index-usecase-dc.png
+ :width: 800px
+
+Chassis Routers
+---------------
+.. image:: images/index-usecase-chassis.png
+ :width: 600px
+
+
+Learn More
+==========
+You can find more information about Trellis including full product brief at https://www.opennetworking.org/trellis/.
.. toctree::
:maxdepth: 1
