From 7279be8b85258be41c1556996e31cd3bc01e2334 Mon Sep 17 00:00:00 2001
From: Steve Wilkerson <wilkers.steve@gmail.com>
Date: Tue, 11 Jul 2017 12:25:14 -0500
Subject: [PATCH] Add specs directory to OpenStack-Helm

Adds the specs/ directory to openstack-helm for housing future
specifications for the project.  It also includes an appropriate
README with directions for drafting specs, links to the openstack
resources for bp+spec lifecycle, and a template for use in
drafting specifications

Change-Id: Ice23447b358b520a8b4fb703fc836e8f09fa34d1
---
 doc/source/index.rst                | 11 +++--
 doc/source/specs/index.rst          | 10 ++++
 doc/source/specs/specifications.rst | 33 ++++++++++++++
 doc/source/specs/template.rst       | 71 +++++++++++++++++++++++++++++
 4 files changed, 120 insertions(+), 5 deletions(-)
 create mode 100644 doc/source/specs/index.rst
 create mode 100644 doc/source/specs/specifications.rst
 create mode 100644 doc/source/specs/template.rst

diff --git a/doc/source/index.rst b/doc/source/index.rst
index aad5e0e5f0..6bac89514f 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -11,13 +11,14 @@ Contents:
 .. toctree::
    :maxdepth: 3
 
-   readme
-   install/index
-   devref/index
    contributing
-   troubleshooting/index
-   testing
+   devref/index
    gates
+   install/index
+   readme
+   specs/index
+   testing
+   troubleshooting/index
 
 Indices and tables
 ==================
diff --git a/doc/source/specs/index.rst b/doc/source/specs/index.rst
new file mode 100644
index 0000000000..0a76827e7b
--- /dev/null
+++ b/doc/source/specs/index.rst
@@ -0,0 +1,10 @@
+Specifications
+==============
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   specifications.rst
+   template.rst
diff --git a/doc/source/specs/specifications.rst b/doc/source/specs/specifications.rst
new file mode 100644
index 0000000000..e7d4f64914
--- /dev/null
+++ b/doc/source/specs/specifications.rst
@@ -0,0 +1,33 @@
+=====================
+Project Specfications
+=====================
+
+Specifications in this repository represent a consensus on the topics covered
+within.  They should be considered a mandate on the path forward with regards
+to the content on which they are drafted.
+
+Purpose
+-------
+
+A specification should precede any broad-reaching technical changes or proposals
+to OpenStack-Helm.  Examples of changes requiring a specification include:  a
+standard format to the values.yaml files, multiple backend support for neutron,
+and the approach for logging and monitoring in OpenStack-Helm.  Some additional
+features will not need an accompanying specification, but may be tied back to an
+existing specification.  An example of this would be introducing a service in
+OpenStack-Helm that could be included under the scope of a specification already
+drafted and approved.
+
+Process
+-------
+
+Before drafting a specification, a blueprint should be filed in Launchpad_ along
+with any dependencies the blueprint requires.  Once the blueprint has been
+registered, submit the specification as a patch set to the specs/ directory
+using the supplied template.
+
+More information about the blueprint + specification lifecycle can be found
+here_.
+
+.. _Launchpad: https://blueprints.launchpad.net/openstack-helm
+.. _here: https://wiki.openstack.org/wiki/Blueprints#Blueprints_and_Specs
diff --git a/doc/source/specs/template.rst b/doc/source/specs/template.rst
new file mode 100644
index 0000000000..0816322425
--- /dev/null
+++ b/doc/source/specs/template.rst
@@ -0,0 +1,71 @@
+..
+ This work is licensed under a Creative Commons Attribution 3.0 Unported
+ License.
+
+ http://creativecommons.org/licenses/by/3.0/legalcode
+
+..
+
+===============
+Blueprint Title
+===============
+
+Include the URL of your Launchpad blueprint:
+
+https://blueprints.launchpad.net/openstack-helm/+spec/example
+
+Problem Description
+===================
+
+A detailed description of the problem.
+
+Use cases
+---------
+1. TODO
+
+Proposed Change
+===============
+
+How do you propose to solve this problem, and what's the scope?
+
+Security Impact
+---------------
+How does this feature impact the securtiy of OpenStack-Helm?
+
+Performance Impact
+------------------
+Does this feature impact the performance of OpenStack-Helm?
+
+Alternatives
+------------
+Why is the proposed approach the best approach?
+
+Implementation
+==============
+
+Assignee(s)
+-----------
+
+Who is leading the implementation?
+
+Designate the primary author and contact.
+
+Primary assignee:
+  <launchpad-id or None>
+
+Work Items
+----------
+
+Work items or tasks.  These can be worked on by multiple contributors.
+
+Testing
+=======
+What tests will verify this change is functional?
+
+Documentation Impact
+====================
+What documentation needs must be considered with this change?
+
+References
+==========
+Place any external references here.