Skip to content

Commit d586671

Browse files
Docs: Clarify GitHub Actions re-run permissions for contributors
1 parent 97a689e commit d586671

1 file changed

Lines changed: 13 additions & 4 deletions

File tree

getting-started/pull-request-lifecycle.rst

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -701,10 +701,19 @@ list of executed checks. Clicking :guilabel:`Update branch` next to this message
701701
will merge in the latest changes from the base branch into the PR.
702702

703703
If this still doesn't help with the failure on the PR, you can try
704-
to re-run that particular failed check. Go to the red GitHub Action job,
705-
click on the :guilabel:`Re-run jobs` button on the top right, and select
706-
:guilabel:`Re-run failed jobs`. The button will only be present when all other
707-
jobs finished running.
704+
to re-run that particular failed check.
705+
706+
Note that the :guilabel:`Re-run jobs` button on GitHub Actions is only visible
707+
to Python core developers and triagers. If you have these permissions, go to
708+
the red GitHub Action job, click on the :guilabel:`Re-run jobs` button on the
709+
top right, and select :guilabel:`Re-run failed jobs`. The button will only be
710+
present when all other jobs finished running.
711+
712+
If you are a regular contributor and cannot see the button, you can ask a
713+
reviewer to re-run the failed jobs for you in a PR comment. Alternatively, you
714+
can re-trigger the CI by pushing an empty commit to your branch (e.g.
715+
``git commit --allow-empty -m "Trigger CI"``), or by closing and re-opening
716+
your pull request.
708717

709718
Re-running failed jobs shouldn't be your first instinct but it is occasionally
710719
helpful because distributed systems can have intermittent failures, and

0 commit comments

Comments
 (0)