create initial structure

Set up the initial structure with a juno directory, several
toctrees, etc.

Tweak the document template.

Change-Id: I9b499ee9e7b9ded9ae5418dda09f8b0c6991b143

doc/source/index.rst

@@ -3,18 +3,19 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-oslo-specs Design Specifications
-==================================================
+============================
+ Oslo Design Specifications
+============================
 
 .. toctree::
    :glob:
    :maxdepth: 2
 
-   ../../specs/*
+   specs/*
 
 
 oslo-specs Repository Information
-===================================================
+=================================
 
 .. toctree::
    :maxdepth: 2

doc/source/specs

@@ -0,0 +1 @@
+../../specs

doc/source/template.rst

@@ -1,14 +1,12 @@
-::
-
-This work is licensed under a Creative Commons Attribution 3.0 Unported License.
-http://creativecommons.org/licenses/by/3.0/legalcode
-
 ..
   This template should be in ReSTructured text. The filename in the git
   repository should match the launchpad URL, for example a URL of
   https://blueprints.launchpad.net/oslo/+spec/awesome-thing should be named
-  awesome-thing.rst .  Please do not delete any of the sections in this
+  awesome-thing.rst.
+
+  Please do not delete any of the sections in this
   template.  If you have nothing to say for a whole section, just write: None
+
   For help with syntax, see http://sphinx-doc.org/rest.html
   To test out your formatting, see http://www.tele3.cz/jbar/rest/rest.html
 
@@ -83,4 +81,11 @@ Dependencies
   projects, that this one either depends on or is related to.
 
 - Does this feature require any new library dependencies or code otherwise not
-  included in OpenStack? Or does it depend on a specific version of library?
+  included in OpenStack? Or does it depend on a specific version of library?
+
+.. note::
+
+  This work is licensed under a Creative Commons Attribution 3.0
+  Unported License.
+  http://creativecommons.org/licenses/by/3.0/legalcode
+

specs/index.rst

@@ -0,0 +1,9 @@
+================
+ Specifications
+================
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   juno/index

specs/juno/index.rst

@@ -0,0 +1,11 @@
+=====================
+ Juno Specifications
+=====================
+
+.. toctree::
+   :glob:
+   :maxdepth: 2
+
+.. FIXME(dhellmann): Uncomment after adding first real spec.
+..   *
+