From 093a9d6244b238d92a2e8065b6120a64f612bd1c Mon Sep 17 00:00:00 2001
From: Andreas Jaeger <aj@suse.com>
Date: Mon, 8 Aug 2016 06:49:59 +0200
Subject: [PATCH] Fix warnings

sphinx complains about:

"
source/specs/task-tracker.rst:231: WARNING: Pygments lexer name
u'storyboard-migration' is not known

checking consistency:
... source/specs/logs-in-swift.rst::
WARNING: document isn't included in any toctree
... source/specs/maniphest.rst::
WARNING: document isn't included in any toctree"

Fix these warnings, the next pbr release will stop again on errors, so
prepare for that.

Fixes are:
* Add toc that includes the two files und new section "Abandoned"
* Fix code-block usage for task-tracker

Change-Id: I6df505e2eb1aa5ff76b2a9d0041de8763ca421a7
---
 doc/source/index.rst   | 11 +++++++++++
 specs/task-tracker.rst |  4 ++--
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/doc/source/index.rst b/doc/source/index.rst
index 623cd43..0713f61 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -90,6 +90,17 @@ for historical purposes.
    specs/translation_setup
    specs/trystack-site
 
+Abandoned Design Specifications
+===============================
+
+These specifications had been approved previously but have not been
+implemented, they have been abandoned.
+
+.. toctree::
+   :maxdepth: 1
+
+   specs/logs-in-swift
+   specs/maniphest
 
 Specifications Repository Information
 =====================================
diff --git a/specs/task-tracker.rst b/specs/task-tracker.rst
index b44b7b9..eeaf00e 100644
--- a/specs/task-tracker.rst
+++ b/specs/task-tracker.rst
@@ -226,9 +226,9 @@ separate, followup spec.
 Gerrit Topic
 ------------
 
-Use Gerrit topic "<topic_name>" for all patches related to this spec.
+Use Gerrit topic "storyboard-migration" for all patches related to this spec.
 
-.. code-block:: storyboard-migration
+.. code-block:: bash
 
     git-review -t storyboard-migration