Add simple diagram for contributor guide promotion stages

Adds diagram to illustrate the tags we use in the promotion
pipeline.

Related-Bug: #1804642
Change-Id: I748a0245d8f3fd6e3682a4a24ab99dcc23022e8e
Co-Authored-By: Sorin Sbarnea <ssbarnea@redhat.com>

doc/source/conf.py

@@ -28,7 +28,8 @@
 extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.intersphinx',
-    'openstackdocstheme'
+    'sphinxcontrib.mermaid',
+    'openstackdocstheme',
 ]
 
 

doc/source/contributor/promotions.mmd

@@ -0,0 +1,5 @@
+graph TD
+    master --> |build-packages|current-consistent
+    current-consistent --> |<a href='http://cistatus.tripleo.org/promotion/'>tripleo-ci promotion</a>|current-tripleo
+    current-tripleo --> |<a href='http://cistatus.tripleo.org/phase1/'>rdo phase1 promotion</a>|current-tripleo-rdo
+    current-tripleo-rdo --> |<a href='http://cistatus.tripleo.org/phase2/'>rdo phase2 promotion</a>|current-tripleo-rdo-internal

doc/source/contributor/stages-overview.rst

@@ -9,6 +9,10 @@ Each stage shows the inputs taken and the artifacts produced.
           Links for stable branches would include the stable release name,
           for example, `Pike stable release <https://trunk.rdoproject.org/centos7-pike/tripleo-ci-testing/>`_.
 
+.. mermaid:: promotions.mmd
+
+*Overview of the tags used during the tripleo promotions stages*
+
 1. **Upstream TripleO**
 
     `CI DLRN Master consistent

test-requirements.txt

@@ -4,6 +4,7 @@
 # Doc requirements
 sphinx>=1.6.2 # BSD
 sphinx_rtd_theme==0.1.7
+sphinxcontrib-mermaid
 
 hacking<1.2.0,>=1.1.0