Add a new section that lists implemented specs for middleware

Currently, we cannot differentiate between implemented and approved
specs for keystoneclient or keystonemiddleware. Created a directory
to move the completed specs to, and created a new section on the
landing page.

Change-Id: I8d36af36586cd6e42bd58a6b1ff5a9337d5728b8

doc/source/index.rst

@@ -31,6 +31,16 @@ Kilo approved specs:
 
       specs/keystoneclient/*
 
+   .. NOTE(stevemar): Uncomment this section after there is at least one
+   implemeted spec for keystoneclient.
+
+   Keystone client implemented specs:
+
+   .. toctree::
+      :glob:
+      :maxdepth: 1
+
+      specs/keystoneclient/implemented/*
 
 Keystone middleware approved specs:
 
@@ -40,6 +50,15 @@ Keystone middleware approved specs:
 
   specs/keystonemiddleware/*
 
+Keystone middleware implemented specs:
+
+.. toctree::
+  :glob:
+  :maxdepth: 1
+
+  specs/keystonemiddleware/implemented/*
+
+
 ==================
 Indices and tables
 ==================

tests/test_titles.py

@@ -11,6 +11,7 @@
 # under the License.
 
 import glob
+import os
 
 import docutils.core
 import testtools
@@ -74,10 +75,11 @@ class TestTitles(testtools.TestCase):
     def test_template(self):
         files = ['specs/template.rst'] + glob.glob('specs/*/*')
         for filename in files:
-            self.assertThat(filename, matchers.EndsWith('.rst'),
-                            'spec\'s file must use the "rst" extension.')
-            with open(filename) as f:
-                data = f.read()
-            spec = docutils.core.publish_doctree(data)
-            titles = self._get_titles(spec)
-            self._check_titles(titles)
+            if not os.path.exists(os.path.dirname(filename)):
+                self.assertThat(filename, matchers.EndsWith('.rst'),
+                                'spec\'s file must use the "rst" extension.')
+                with open(filename) as f:
+                    data = f.read()
+                spec = docutils.core.publish_doctree(data)
+                titles = self._get_titles(spec)
+                self._check_titles(titles)