Draft: Clarify stuck_or_timeout_failure retry reasons
What does this MR do?
Updates the retry:when documentation
and the GitLab 19.0 release notes to reflect the new, more specific CI job failure
reasons that replace the generic stuck_or_timeout_failure value, as introduced by
!230787 (merged) and described
in #595752 (closed).
Changes
doc/ci/yaml/_index.md— Updates theretry:whenkeyword reference:- Adds a note clarifying that
stuck_or_timeout_failureis preserved for historical data only. - Documents the new failure reasons:
stuck_pending_with_matching_runnersstuck_pending_no_matching_runnersno_updates_runningno_updates_cancelingserver_timeout_runningserver_timeout_canceling
- Updates the array example for
retry:whento use the new, more specific values.
- Adds a note clarifying that
doc/releases/19/gitlab-19-0-released.md— Adds a 19.0 release note entry under Unified DevOps and Security describing the new failure reasons.
Related issues and MRs
- Documents change introduced by !230787 (merged).
- Addresses the documentation acceptance criterion in #595752 (closed).
- Related to the broader job failure reason standardization in #595703 (closed).
Author's checklist
- Optional. Consider taking the GitLab Technical Writing Fundamentals course.
- Follow the:
- If you have
developeraccess or higher (for example, GitLab team members or Core Team members):- Apply the
documentationlabel, plus:- The corresponding DevOps stage and group labels, if applicable.
tw-labels for the relevant technical writer, if known.
- Assign the designated Technical Writer.
- Apply the
Review checklist
Documentation-related MRs should be reviewed by a Technical Writer for a non-blocking review, based on Documentation Codeowners.
- If you're adding or changing the structure of the documentation, the SSOT navigation must be updated.
- Ensure docs metadata is present and up-to-date.
- Ensure that the product tier badge is added to doc's metadata.
- Review by assigned maintainer, who can always request/require the above reviews. Maintainer's review can occur before or after a technical writer review.
Edited by drew stachon