Separate kilo and juno specs

Need to split out the different releases so the index page will continue
to scale past the current two releases.

It required some rework how the specs are symlinked into the doc source
to allow for the release specific landing pages.

Change-Id: I31fa0b13e400dd202f5db3e63da7b7c8dbd40e68

doc/source/conf.py

@@ -71,7 +71,6 @@ copyright = u'%s, OpenStack Nova Team' % datetime.date.today().year
 # directories to ignore when looking for source files.
 exclude_patterns = [
     '_build',
-    'specs/juno-template.rst',
 ]
 
 # The reST default role (used for this markup: `text`) to use for all documents.

doc/source/index.rst

@@ -1,8 +1,14 @@
 .. nova-specs documentation master file
 
-========================
-Nova Project Priorities
-========================
+============================
+OpenStack Nova Project Plans
+============================
+
+Priorities
+==========
+
+During each design summit, we agree what the whole community wants to focus
+on for the upcoming release. This is the output of those discussions:
 
 .. toctree::
    :glob:
@@ -10,44 +16,31 @@ Nova Project Priorities
 
    priorities/*
 
+Specifications
+==============
 
-===========================
-Nova Project Specifications
-===========================
-
-Project Documentation:
-
-.. toctree::
-   :maxdepth: 1
-
-   readme
-   Specification Template (Kilo) <specs/kilo-template>
-
-Juno implemented specs:
+Here you can find the specs, and spec template, for each release:
 
 .. toctree::
    :glob:
    :maxdepth: 1
 
-   specs/juno/implemented/*
+   specs/kilo/index
+   specs/juno/index
 
-Juno approved (but not implemented) specs:
+Process
+=======
+
+Documentation for nova-specs process:
 
 .. toctree::
-   :glob:
    :maxdepth: 1
 
-   specs/juno/approved/*
+   How to submit a spec <readme>
 
-Kilo approved (but not implemented) specs:
+For more details, look at spec template for the specific release, and see the
+wiki page on Blueprints: https://wiki.openstack.org/wiki/Blueprints
 
-.. toctree::
-   :glob:
-   :maxdepth: 1
-
-   specs/kilo/approved/*
-
-==================
 Indices and tables
 ==================
 

doc/source/specs

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

doc/source/specs/juno/approved

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

doc/source/specs/juno/implemented

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

doc/source/specs/juno/index.rst

@@ -0,0 +1,26 @@
+===========================
+Nova Juno Specifications
+===========================
+
+Template:
+
+.. toctree::
+   :maxdepth: 1
+
+   Specification Template (Juno) <template>
+
+Juno implemented specs:
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   implemented/*
+
+Juno approved (but not implemented) specs:
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   approved/*

doc/source/specs/juno/redirects

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

doc/source/specs/juno/template.rst

@@ -0,0 +1 @@
+../../../../specs/juno-template.rst

doc/source/specs/kilo/approved

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

doc/source/specs/kilo/index.rst

@@ -0,0 +1,18 @@
+===========================
+Nova Kilo Specifications
+===========================
+
+Template:
+
+.. toctree::
+   :maxdepth: 1
+
+   Specification Template (Kilo) <template>
+
+Kilo approved (but not implemented) specs:
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   approved/*

doc/source/specs/kilo/template.rst

@@ -0,0 +1 @@
+../../../../specs/kilo-template.rst