From 936cf1675310e8d0d166768809fcf236107be180 Mon Sep 17 00:00:00 2001
From: Bogdan Dobrelya <bdobreli@redhat.com>
Date: Tue, 22 Aug 2017 12:08:04 +0200
Subject: [PATCH] Add a docs section for troubleshooting failed jobs

Change-Id: I7b30f850802d523f300bf10361b22a0aaced3843
Signed-off-by: Bogdan Dobrelya <bdobreli@redhat.com>
---
 doc/source/contributor/check_gates.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/doc/source/contributor/check_gates.rst b/doc/source/contributor/check_gates.rst
index 1c52b78b..314d3f56 100644
--- a/doc/source/contributor/check_gates.rst
+++ b/doc/source/contributor/check_gates.rst
@@ -110,7 +110,14 @@ For example::
 
 **Note** the example does **not** append ``-nv`` as a suffix to the job name
 
-
+Troubleshooting a failed job
+----------------------------
+
+When your newly added job fails, you may want to download its logs for a local
+inspection and root cause analysis. Use the
+`tripleo-ci gethelogs script
+<https://github.com/openstack-infra/tripleo-ci/blob/master/scripts/getthelogs>`_
+for that.