6 files changed, 126 insertions, 0 deletions
diff --git a/docs/design/architecture.rst b/docs/design/architecture.rst
new file mode 100644
index 00000000..24be1675
--- /dev/null
+++ b/docs/design/architecture.rst
@@ -0,0 +1,4 @@
+Architecture
+============
+
+This section will describe the architectural approach to incorporating SFC into the OPNFV platform.
+\ No newline at end of file
diff --git a/docs/design/definitions.rst b/docs/design/definitions.rst
new file mode 100644
index 00000000..effaf0ec
--- /dev/null
+++ b/docs/design/definitions.rst
@@ -0,0 +1,59 @@
+Definitions
+===========
+
+Definitions of most terms used here are provided in the `IETF SFC Architecture draft <https://datatracker.ietf.org/doc/draft-ietf-sfc-architecture/>`_. Additional terms specific to the OPNFV SFC project are defined below.
+
+.. list-table:: Definitions
+   :widths: 15 85
+   :header-rows: 1
+
+   * - Term
+     - Meaning
+
+   * - ...
+     - ...
+
+Abbreviations
+=============
+.. list-table:: Abbreviations
+   :widths: 15 85
+   :header-rows: 1
+
+   * - Abbreviation
+     - Term
+
+   * - NS
+     - Network Service
+
+   * - NFVO
+     - Network Function Virtualization Orchestrator
+
+   * - NF
+     - Network Function
+
+   * - RSP
+     - Rendered Service Path
+
+   * - SF
+     - Service Function
+
+   * - SFC
+     - Service Function Chain(ing)
+
+   * - SFF
+     - Service Function Forwarder
+
+   * - SFP
+     - Service Function Path
+
+   * - VNF
+     - Virtual Network Function
+
+   * - VNFM
+     - Virtual Network Function Manager
+
+   * - VNF-FG
+     - Virtual Network Function Forwarding Graph
+
+   * - VIM
+     - Virtual Infrastructure Manager
diff --git a/docs/design/index.rst b/docs/design/index.rst
new file mode 100644
index 00000000..c878b872
--- /dev/null
+++ b/docs/design/index.rst
@@ -0,0 +1,32 @@
+.. OPNFV Service Function Chaining (SFC) documentation
+
+.. image:: ../etc/opnfv-logo.png
+  :height: 40
+  :width: 200
+  :alt: OPNFV
+  :align: left
+|
+|
+Service Function Chaining (SFC)
+===============================
+
+Contents:
+
+.. toctree::
+   :numbered:
+   :maxdepth: 4
+
+   introduction.rst
+   definitions.rst
+   usecases.rst
+   architecture.rst
+   requirements.rst
+
+Indices and tables
+==================
+
+* :ref:`search`
+
+Revision: _sha1_
+
+Build date: |today|
diff --git a/docs/design/introduction.rst b/docs/design/introduction.rst
new file mode 100644
index 00000000..746ba05c
--- /dev/null
+++ b/docs/design/introduction.rst
@@ -0,0 +1,23 @@
+.. two dots create a comment. please leave this logo at the top of each of your rst files.
+.. image:: ../etc/opnfv-logo.png 
+  :height: 40
+  :width: 200
+  :alt: OPNFV
+  :align: left
+.. these two pipes are to seperate the logo from the first title
+|
+|
+Introduction
+============
+
+..
+ This work is licensed under a Creative Commons Attribution 3.0 Unported License.
+
+ http://creativecommons.org/licenses/by/3.0/legalcode
+ 
+.. NOTE::
+   This is the working documentation for the SFC project.
+
+The `OPNFV Service Function Chaining (SFC) <https://wiki.opnfv.org/sfc>`_ project aims to provide the ability to define an ordered list of a network services (e.g. firewalls, NAT, QoS). These service are then "stitched" together in the network to create a service chain. This project provides the infrastructure to install the upstream ODL SFC implementation project in an NFV environment.
+
+
diff --git a/docs/design/requirements.rst b/docs/design/requirements.rst
new file mode 100644
index 00000000..dbedc6f7
--- /dev/null
+++ b/docs/design/requirements.rst
@@ -0,0 +1,4 @@
+Requirements
+============
+
+This section will define requirements for the initial OPNFV SFC implementation, including those requirements driving upstream project enhancements.
diff --git a/docs/design/usecases.rst b/docs/design/usecases.rst
new file mode 100644
index 00000000..9b886982
--- /dev/null
+++ b/docs/design/usecases.rst
@@ -0,0 +1,4 @@
+Use Cases
+=========
+
+This section will outline use cases driving the initial OPNFV SFC implementation.
+\ No newline at end of file