[PATCH] D112775: [docs] Consolidate instructions for reporting a problem with builder in one place

[Philip Reames via Phabricator via llvm-commits]

reames created this revision.
reames added reviewers: gkistanova, andreil99, mehdi_amini.
Herald added subscribers: bollu, mcrosier.
reames requested review of this revision.
Herald added a project: LLVM.

Repository:
  rG LLVM Github Monorepo

https://reviews.llvm.org/D112775

Files:
  llvm/docs/DeveloperPolicy.rst
  llvm/docs/HowToAddABuilder.rst


Index: llvm/docs/HowToAddABuilder.rst
===================================================================
--- llvm/docs/HowToAddABuilder.rst
+++ llvm/docs/HowToAddABuilder.rst
@@ -46,8 +46,25 @@
 the contact listed in a workers attributes - to proxy requests to the relevant
 "config owner" in a timely manner.
 
-Most issues with a buildbot should be addressed directly with a bot owner
-via email.  Please CC `Galina Kistanova <mailto:gkistanova at gmail.com>`_.
+Reporting a problem
+===================
+
+As a first step, most issues with a buildbot should be addressed directly
+with the bot owner via email.  Please CC
+`Galina Kistanova <mailto:gkistanova at gmail.com>`_.
+
+You can find the name and contact information for the *Admin* of worker on
+the page of the build in the *Worker* tab:
+
+  .. image:: buildbot_worker_contact.png
+
+If you don't get a timely response, or the reported issue is not addressed
+to your satisfaction, please forward the email directly to Galina in the "To:"
+field of the email.  She should have already been CCd, but tends to be CCd
+on many threads and making it clear whose response you're expecting is helpful.
+
+If Galina could not help you (e.g. is on vacation, busy, etc..), please
+escalate to the  `Infrastructure Working Group <mailto:iwg at llvm.org>`_.
 
 Steps To Add Builder To LLVM Buildbot
 =====================================
Index: llvm/docs/DeveloperPolicy.rst
===================================================================
--- llvm/docs/DeveloperPolicy.rst
+++ llvm/docs/DeveloperPolicy.rst
@@ -675,18 +675,9 @@
   understand the problem.
 * Revert the commit if this blocks your work, see revert_policy_ .
 
-*If a build/worker is permanently broken*
-
-* 1st step: contact the owner of the worker. You can find the name and contact
-  information for the *Admin* of worker on the page of the build in the 
-  *Worker* tab:
-
-  .. image:: buildbot_worker_contact.png
-
-* 2nd step: If the owner does not respond or fix the worker, please escalate 
-  to Galina Kostanova, the maintainer of the BuildBot master.
-* 3rd step: If Galina could not help you, please escalate to the 
-  `Infrastructure Working Group <mailto:iwg at llvm.org>`_.
+*If a build/worker is permanently broken*, please
+`follow the procedures <HowToAddABuilder.htmlp#reporting-a-problem>`_ for
+reporting a problem with the worker/builtbot itself.
 
 .. _new-llvm-components:
 


-------------- next part --------------
A non-text attachment was scrubbed...
Name: D112775.383216.patch
Type: text/x-patch
Size: 2414 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20211029/386c95ed/attachment.bin>