Skip to content

Commit cc130aa

Browse files
Docs: Clarify GitHub Actions re-run permissions for contributors
1 parent 17ee1fd commit cc130aa

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
@@ -667,10 +667,19 @@ list of executed checks. Clicking :guilabel:`Update branch` next to this message
667667
will merge in the latest changes from the base branch into the PR.
668668

669669
If this still doesn't help with the failure on the PR, you can try
670-
to re-run that particular failed check. Go to the red GitHub Action job,
671-
click on the :guilabel:`Re-run jobs` button on the top right, and select
672-
:guilabel:`Re-run failed jobs`. The button will only be present when all other
673-
jobs finished running.
670+
to re-run that particular failed check.
671+
672+
Note that the :guilabel:`Re-run jobs` button on GitHub Actions is only visible
673+
to Python core developers and triagers. If you have these permissions, go to
674+
the red GitHub Action job, click on the :guilabel:`Re-run jobs` button on the
675+
top right, and select :guilabel:`Re-run failed jobs`. The button will only be
676+
present when all other jobs finished running.
677+
678+
If you are a regular contributor and cannot see the button, you can ask a
679+
reviewer to re-run the failed jobs for you in a PR comment. Alternatively, you
680+
can re-trigger the CI by pushing an empty commit to your branch (e.g.
681+
``git commit --allow-empty -m "Trigger CI"``), or by closing and re-opening
682+
your pull request.
674683

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

0 commit comments

Comments
 (0)