[docs] Remove bloat from integrity filtering reference#25977
Closed
github-actions[bot] wants to merge 1 commit intomainfrom
Closed
[docs] Remove bloat from integrity filtering reference#25977github-actions[bot] wants to merge 1 commit intomainfrom
github-actions[bot] wants to merge 1 commit intomainfrom
Conversation
Condense level descriptions, remove 6 redundant examples already shown in subsections, and tighten prose throughout. 398 → 318 lines (20.1%). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Reduces
docs/src/content/docs/reference/integrity.mdfrom 398 → 318 lines (80 lines, 20.1% reduction) while preserving all essential information.What was removed
Verbose level descriptions — The five integrity-level descriptions (merged, approved, unapproved, none, blocked) each contained paragraph-length text that repeated information already in the table above and the "Choosing a Level" section below. Condensed to single-sentence summaries that retain the technically unique details (e.g., private-repo elevation, bot trust, CONTRIBUTOR classification).
6 redundant Examples — The Examples section contained 11 examples; 6 were identical to examples already shown inline in their respective subsections:
Kept the "Combined: blocking, trusting, and labeling" example (unique) plus the four single-field examples.
Prose tightening — Removed trailing sentences that restated what was just said ("This mechanism allows a security team to...", "This is useful when a workflow's min-integrity would normally filter out..."), condensed the proxy bullet list to prose, simplified the Default Behavior section, and removed the intro sentence from Choosing a Level.
Estimated reduction
Screenshots
Visual screenshots were unavailable due to network isolation between the Playwright container and the agent container (
net::ERR_CONNECTION_TIMED_OUT). The page was verified to render correctly via curl — HTTP 200, all 13 section headings confirmed present (How It Works, Configuration, Configuration Reference, Integrity Levels, Scoping to Repositories, Adjusting Integrity Per-Item, Centralized Management via GitHub Variables, Default Behavior, Pre-Agent Integrity Proxy, Choosing a Level, Examples, In Logs and Reports, Related Documentation).Blocked domains: Not applicable (screenshots not captured).
References: §24324801347