docs(workflow): fix action reference accuracy and style drift - #12206
Merged
Conversation
Member
Author
|
This pull request is part of a Mergify stack:
|
This was referenced Jul 26, 2026
Contributor
Merge Protections🟢 All 7 merge protections satisfied — ready to merge. Show 7 satisfied protections🟢 ⛓️ Depends-On RequirementsRequirement based on the presence of
🟢 🤖 Continuous Integration
🟢 👀 Review Requirements
🟢 Enforce conventional commitMake sure that we follow https://www.conventionalcommits.org/en/v1.0.0/
🟢 🔎 Reviews
🟢 📕 PR description
🟢 🚦 Auto-queueWhen all merge protections are satisfied, this pull request will be queued automatically. |
jd
marked this pull request as ready for review
July 26, 2026 08:19
First docs-health audit pass over the action reference pages. Accuracy fixes verified against the config JSON schema and the engine source: - queue: reference `auto_merge_conditions` instead of the deprecated `auto_merge` - comment: fix the copy-pasted rule name in the conflict example (was "comment when a pull request is merged" on a `conflict` condition) - delete_head_branch and rebase: convert dated deprecation notices to dateless markers per the repo rule (both dates had passed; the delete_head_branch date also disagreed with the engine's actual deadline, flagged separately in the audit report) - post_check: drop the unused Button import; name Merge Protections as the feature in prose Every documented option, default, and enum on all 21 action pages was cross-checked against the schema; the rest were accurate. Plus a conservative style pass per the proofread rubrics: banned words, promotional filler sentences, em dashes, and a dozen grammar fixes across 15 pages. Part of the first manual docs-health audit (MRGFY-8212). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Change-Id: I2b9d507db7a3e2ab566d70b0b15a28031f427962
jd
force-pushed
the
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-action-ref-accuracy-style-drift--2b9d507d
branch
from
July 26, 2026 08:23
da17747 to
151c2d1
Compare
jd
force-pushed
the
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-ref-accuracy-style-drift--a5524167
branch
from
July 26, 2026 08:23
23a05f1 to
3b32271
Compare
Member
Author
Revision history
|
JulianMaurin
previously approved these changes
Jul 27, 2026
Base automatically changed from
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-ref-accuracy-style-drift--a5524167
to
main
July 27, 2026 07:32
mergify
Bot
force-pushed
the
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-action-ref-accuracy-style-drift--2b9d507d
branch
from
July 27, 2026 07:32
151c2d1 to
8207564
Compare
kozlek
approved these changes
Jul 27, 2026
JulianMaurin
approved these changes
Jul 27, 2026
Contributor
Merge Queue Status
This pull request spent 2 minutes 24 seconds in the queue, including 2 minutes 1 second running CI. Required conditions to merge
|
55 tasks
mergify
Bot
deleted the
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-action-ref-accuracy-style-drift--2b9d507d
branch
July 27, 2026 07:37
55 tasks
mergify Bot
pushed a commit
that referenced
this pull request
Jul 27, 2026
…12207) First docs-health audit pass over all merge-queue pages. Accuracy fixes verified against the config JSON schema, the CLI schema, and the engine: - github-rulesets: add the missing `none` value of `branch_protection_injection_mode` (schema enum queue|merge|none) - scopes: remove the wrong "set `merge_queue_scope` to `null` to disable" claim (schema types it non-nullable) - batches: "split into two by default" was stale; the engine splits a failed batch into max(2, max_parallel_checks) parts - queue-modes: isolated-mode batching without scopes fills by changed-directory similarity, not pure arrival order; fast-forward restriction list was missing `squash` as an allowed method - lifecycle: reference `auto_merge_conditions` instead of the deprecated `auto_merge` - pause: `--reason` is required, not optional (CLI schema); fix the broken freeze anchor to /merge-protections/freeze - monitoring: match the dashboard UI text ("Past 3 months") - rules and merge-strategies: convert expired dated deprecation notices (autoqueue, fork-rebase) to dateless markers per the repo rule Plus a conservative style pass per the proofread rubrics: banned words, ~50 prose em dashes, throat-clearing intros, promotional filler, and grammar fixes. Frontmatter descriptions with banned words or em dashes were also cleaned (quoted where a colon required it). Part of the first manual docs-health audit (MRGFY-8212). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Depends-On: #12206
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.
First docs-health audit pass over the action reference pages. Accuracy fixes
verified against the config JSON schema and the engine source:
auto_merge_conditionsinstead of the deprecatedauto_merge"comment when a pull request is merged" on a
conflictcondition)dateless markers per the repo rule (both dates had passed; the
delete_head_branch date also disagreed with the engine's actual deadline,
flagged separately in the audit report)
feature in prose
Every documented option, default, and enum on all 21 action pages was
cross-checked against the schema; the rest were accurate.
Plus a conservative style pass per the proofread rubrics: banned words,
promotional filler sentences, em dashes, and a dozen grammar fixes across
15 pages.
Part of the first manual docs-health audit (MRGFY-8212).
Co-Authored-By: Claude Fable 5 noreply@anthropic.com
Depends-On: #12205