Unique rST file names

As discussed, a simple script to create stubs with unique names and labels.
Prefix name of index files with "index-" to distinguish them from 'regular'
files.
Added missing "::" to templated rubrics.
Remove unneeded echo.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I8f7dd8f4a57655032de6913d4570f5ca5c2b9338
Signed-off-by: Ron Stone <ronald.stone@windriver.com>

templates/topic-templates.txt

@@ -0,0 +1,78 @@
+echo "Loading topic types ..."
+
+# Add convenience templates for rst content here.
+
+# Task-oriented procedures
+task=".. _$filename:
+
+$strike
+$title
+$strike
+
+.. rubric:: |context|
+
+.. context here
+
+.. rubric:: |prereq|
+
+.. prerequisites here
+
+.. rubric:: |proc|
+
+#. Step 1
+
+#. Step 2
+
+.. rubric:: |result|
+
+.. procedure results here
+"
+# EOT
+
+
+# Index file names should be unique across all repos
+index=".. _$filename:
+
+$strike
+$title
+$strike
+
+.. Uncomment topic-a etc. below and replace with the names of your topics,
+   excluding the ".rst" extension
+
+.. toctree::
+   :maxdepth: 2
+
+..   topic-a
+..   topic-b
+"
+
+# Tabular data
+reference=".. _$filename:
+
+$strike
+$title
+$strike
+
+.. See https://docutils.sourceforge.io/docs/ref/rst/directives.html#list-table
+
+.. list-table::
+
+   * - Column 1
+     - Column 2
+     - Column 3
+   * - Row 1, value 1
+     - Value 1
+     - Value 2
+"
+
+# Generic topic
+topic=".. _$filename:
+
+$strike
+$title
+$strike
+
+.. content here
+
+"