Fix generation of docs

Docs for tempest are not being generated properly

Depends-On: https://review.openstack.org/#/c/566527/

Change-Id: I0cc8d0487b144026a6dadd4345bcc97800fbdcfc

roles/validate-tempest/files/tempestmail/config2.yaml

@@ -0,0 +1,11 @@
+require_auth: True
+mail_from: tripleoresults@gmail.com
+templates_path: template/
+log_url: 'http://logs.openstack.org/periodic/'
+api_server: 'http://tempest-sendmail.tripleo.org:8080/api/v1.0/sendmail'
+use_api_server: True
+default_log_url: 'http://logs.openstack.org'
+emails:
+  - mail: 'arxcruz@gmail.com'
+    name: 'Arx Cruz'
+template: template.html

roles/validate-tempest/templates/configure-tempest.sh.j2

@@ -1,5 +1,3 @@
-### --start_docs
-
 ## Configure tempest
 ## -----------------
 
@@ -163,6 +161,4 @@ $TEMPESTCONF --out etc/tempest.conf \
   {% endfor %}
   {% endif %}
   compute-feature-enabled.console_output true \
-  orchestration.stack_owner_role Member
-
-### --stop_docs
+  orchestration.stack_owner_role Member

roles/validate-tempest/templates/run-tempest.sh.j2

@@ -1,5 +1,3 @@
-### --start_docs
-
 ## Run tempest
 ## -----------
 
@@ -14,10 +12,15 @@ export TEMPESTCLI='/usr/bin/tempest'
 {% endif %}
 
 ## List tempest plugins
+
+## ::
+
 $TEMPESTCLI list-plugins
 
 ## Save the resources before running tempest tests
 ## It will create saved_state.json in tempest workspace.
+## ::
+
 {% if tempest_track_resources|bool %}
 $TEMPESTCLI cleanup --init-saved-state
 {% endif %}
@@ -31,6 +34,8 @@ $TEMPESTCLI cleanup --init-saved-state
 
 ## Check which all tenants would be modified in the tempest run
 ## It will create dry_run.json in tempest workspace.
+## ::
+
 {% if tempest_track_resources|bool %}
 $TEMPESTCLI cleanup --dry-run
 {% endif %}

roles/validate-tempest/templates/tempest-setup.j2

@@ -3,7 +3,6 @@
 set -eux
 
 ### --start_docs
-
 ## Validate the overcloud deployment with tempest
 ## ==============================================