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

  1. doc/ci/yaml/_index.md — Updates the retry:when keyword reference:
    • Adds a note clarifying that stuck_or_timeout_failure is preserved for historical data only.
    • Documents the new failure reasons:
      • stuck_pending_with_matching_runners
      • stuck_pending_no_matching_runners
      • no_updates_running
      • no_updates_canceling
      • server_timeout_running
      • server_timeout_canceling
    • Updates the array example for retry:when to use the new, more specific values.
  2. 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.

Author's checklist

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

Merge request reports

Loading