Docs: Clarify baseline pipeline selection for MR metrics reports
What does this MR do?
Adds a "How baseline comparison works" subsection to the metrics reports documentation explaining:
- The SHA cascade fallback strategy used to find a baseline pipeline
(
target_sha→diff_base_sha→diff_start_sha) - That no pipeline status filter is applied to the baseline selection
- The difference between merge request pipelines and branch pipelines for baseline resolution
- Guidance on ensuring a baseline is always available
Also cross-references the new section from the existing troubleshooting entry.
Related issues
Closes #593215
Author's checklist
- Optional. Consider taking the GitLab Technical Writing Fundamentals course.
- Follow the:
- If you're adding a new page, add the product availability details under the H1 topic title.
-
If you are a GitLab team member, request a review based on:
- The documentation page's metadata.
- The associated Technical Writer.
AI-Generated Content Disclosure: This MR contains content generated with assistance from GitLab Duo and OpenCode. The output has been reviewed for correctness, tested, and validated against project requirements per GitLab's AI contribution guidelines.
Edited by Andrew Dunn