Skip to content

docs(flaky-tests): document quarantine status icons on repositories overview#553

Draft
samgutentag wants to merge 1 commit intomainfrom
sam-gutentag/flaky-tests-repos-overview-quarantine-icons
Draft

docs(flaky-tests): document quarantine status icons on repositories overview#553
samgutentag wants to merge 1 commit intomainfrom
sam-gutentag/flaky-tests-repos-overview-quarantine-icons

Conversation

@samgutentag
Copy link
Copy Markdown
Member

Summary

  • Adds a Repositories overview section to flaky-tests/dashboard.md
  • Documents the quarantine status icons introduced in trunk-io/trunk2#3538:
    • Shield icon: quarantining is enabled, auto-quarantine is off
    • Shield with checkmark icon: auto-quarantine is enabled
  • Includes full column reference for the repos overview table (Tests, Flaky, Broken, Runs/Day)
  • Links to the Quarantining page for configuration details

Source

Notes

This PR overlaps with #549 which documents the initial repos overview feature (trunk-io/trunk2#3527). One of the two should be updated to include the other's content before merging, or they can be merged in sequence with a follow-up cleanup.

Test plan

  • Preview in GitBook

…verview

The repositories overview now shows Shield (quarantining on, auto-quarantine
off) and ShieldCheck (auto-quarantine enabled) icons next to repo names.
Adds the full repositories overview section with column reference and icon
legend.

Source: trunk-io/trunk2#3538

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@trunk-staging-io
Copy link
Copy Markdown

Merging to main in this repository is managed by Trunk.

  • To merge this pull request, check the box to the left or comment /trunk merge below.

After your PR is submitted to the merge queue, this comment will be automatically updated with its status. If the PR fails, failure details will also be posted here

@claude
Copy link
Copy Markdown
Contributor

claude bot commented Apr 16, 2026

Claude finished @samgutentag's task in 1m 14s —— View job


Review Complete

  • Gather context (read CLAUDE.md and changed file)
  • Review for typos, grammar, and formatting issues
  • Review for documentation best practices
  • Post inline comments and final verdict

The new Repositories overview section is well-structured, clear, and fits naturally before the existing "Key repository metrics" section. Content is accurate and easy to follow. Two minor suggestions posted as inline comments:

  1. Line 22 — "hover tooltips" is slightly redundant; "per-day tooltips" is cleaner.
  2. Lines 28–29 — Icon table rows use inconsistent separators (; vs ); suggest standardizing to em dashes.

Neither is blocking. The section could benefit from a screenshot (other sections include figures), but that's a nice-to-have given this documents a new feature.

Comment thread flaky-tests/dashboard.md
| **Tests** | Total tracked test cases in the repository (60-day window) |
| **Flaky** | Number of currently flaky test cases, with a 10-day trend sparkline |
| **Broken** | Number of currently broken test cases, with a 10-day trend sparkline |
| **Runs / Day** | Bar chart of test run volume over the last 10 days, with per-day hover tooltips |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor: "hover tooltips" is slightly redundant — tooltips by definition appear on hover. Consider simplifying:

Suggested change
| **Runs / Day** | Bar chart of test run volume over the last 10 days, with per-day hover tooltips |
| **Runs / Day** | Bar chart of test run volume over the last 10 days, with per-day tooltips |

Comment thread flaky-tests/dashboard.md
Comment on lines +28 to +29
| Shield | Quarantining is enabled for this repository; auto-quarantine is off |
| Shield with checkmark | Auto-quarantine is enabled — flaky tests are quarantined automatically |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The two rows use different separators — the first uses a semicolon (;) and the second an em dash (). Using a consistent style would be cleaner:

Suggested change
| Shield | Quarantining is enabled for this repository; auto-quarantine is off |
| Shield with checkmark | Auto-quarantine is enabled — flaky tests are quarantined automatically |
| Shield | Quarantining is enabled for this repository auto-quarantine is off |
| Shield with checkmark | Auto-quarantine is enabled — flaky tests are quarantined automatically |

Copy link
Copy Markdown

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Auto-approved: Claude code review passed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants