Update with docs about new flake detection configuration

[mmatheson]

No description provided.

[trunk-staging-io]

✨ Submitted to Merge by github-actions[bot]. It will be added to the merge queue once all branch protection rules pass and there are no merge conflicts with the target branch. See more details here.

[claude]

Claude finished @mmatheson's task in 2m 38s —— View job

---

PR Review: Update with docs about new flake detection configuration

• Gather context
• Read new documentation files
• Review for typos, grammar, and formatting
• Post inline comments
• Final summary

---

Summary

This PR reorganizes flake detection documentation from a single detection.md file into a structured detection/ directory with dedicated pages per monitor type. The content is well-written, logically organized, and technically accurate. Link updates across 50+ framework/CI provider files are consistent and correct.

Findings

Minor issues (non-blocking):

1. Screenshot placeholders — HTML comment blocks (``) remain in 3 new files as developer notes for where screenshots should be added:

   • detection/README.md (1 block)
   • detection/pass-on-retry-monitor.md (1 block)
   • detection/threshold-monitor.md (3 blocks)

   These don't render to users, but should be removed if screenshots won't be added before publishing. See inline comments →

2. Trailing space in code block title — uploader.md line 120 has {% code %} with a trailing space. Fix suggested →

What looks good

• The monitor architecture (additive model, muting, events) is clearly explained with helpful Mermaid diagrams
• Branch pattern syntax table and examples in threshold-monitor.md are thorough and accurate
• Recommended configurations section provides practical, actionable guidance
• All links from detection.md → detection/ have been updated correctly; no broken links remain
• flag-as-flaky.md cleanly replaces the removed manual monitor concept

No blocking issues found.

[claude]

These `` comment blocks appear throughout the new detection docs as placeholder notes for future screenshots. HTML comments won't render to users, but they add noise to the source. If screenshots will be added before publishing, these are fine to keep temporarily — otherwise they should be removed.

[claude]

Same screenshot placeholder note as in README.md — consider removing if screenshots won't be added before this is published.

[claude]

Screenshot placeholder comment — same note as other files. Three of these exist in this file (lines 29–35, 143–147, 209–214). Remove if screenshots won't be added before publishing.

[claude]

Trailing space in the code block title: "Upload an iOS variant " — should be "Upload an iOS variant".

Suggested change

	{% code %}

[github-actions]

/trunk merge

[github-actions]

Auto-approved: Claude code review passed.