Skip to content

docs: close gaps found by docs-gap-analysis#11996

Open
jd wants to merge 1 commit into
devs/jd/worktree-skill/add-docs-authoring-maintenance-skills--e17e7c54from
devs/jd/worktree-skill/close-gaps-found-docs-gap-analysis--57ed4284
Open

docs: close gaps found by docs-gap-analysis#11996
jd wants to merge 1 commit into
devs/jd/worktree-skill/add-docs-authoring-maintenance-skills--e17e7c54from
devs/jd/worktree-skill/close-gaps-found-docs-gap-analysis--57ed4284

Conversation

@jd

@jd jd commented Jun 30, 2026

Copy link
Copy Markdown
Member

Corrections surfaced by the new docs-gap-analysis skill against the last
90 days of changelog entries:

  • configuration/conditions.mdx: document {{ author }} as a built-in
    condition value, and add prose for the check-cancelled and scope
    condition attributes (previously only rendered in the generated table)
  • ci-insights/auto-retry.mdx: rules are now scoped per repository via the
    repository selector (the per-rule repository condition is no longer
    needed); mention the "Test your log patterns" tester in the rule builder
  • merge-queue/github-rulesets.mdx: document that Mergify honors GitHub's
    "Require approval of the most recent push" by auto-injecting the matching
    condition
  • merge-queue/scopes.mdx: fix broken cross-link
    (/merge-queue/parallel-scopes -> /merge-queue/queue-modes#limiting-concurrency-per-scope)

Verified with the proofread pipeline (style/technical/structure/consistency)
and pnpm check (0 errors). The stale allow_checks_interruption default in
merge-queue/priority.mdx is intentionally NOT changed: the schema still says
default true while the changelog says false, so it needs product confirmation.

Co-Authored-By: Claude Opus 4.8 (1M context) noreply@anthropic.com

Depends-On: #11975

@jd

jd commented Jun 30, 2026

Copy link
Copy Markdown
Member Author

This pull request is part of a Mergify stack:

# Pull Request Link
1 feat(skills): add docs authoring and maintenance skills #11975
2 docs: close gaps found by docs-gap-analysis #11996 👈

@mergify mergify Bot had a problem deploying to Mergify Merge Protections June 30, 2026 15:20 Failure
@mergify

mergify Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Merge Protections

🔴 2 of 7 protections blocking · waiting on 👀 reviews

Protection Waiting on
🔴 👀 Review Requirements 👀 reviews
🔴 🔎 Reviews 👀 reviews
🟢 ⛓️ Depends-On Requirements
🟢 🤖 Continuous Integration
🟢 Enforce conventional commit
🟢 📕 PR description
🟢 🚦 Auto-queue

🔴 👀 Review Requirements

Waiting for

  • #approved-reviews-by >= 2
This rule is failing.
  • any of:
    • #approved-reviews-by >= 2
    • author = dependabot[bot]
    • author = mergify-ci-bot

🔴 🔎 Reviews

Waiting for

  • #review-requested = 0
This rule is failing.
  • #review-requested = 0
  • #changes-requested-reviews-by = 0
  • #review-threads-unresolved = 0

Show 5 satisfied protections

🟢 ⛓️ Depends-On Requirements

Requirement based on the presence of Depends-On in the body of the pull request

🟢 🤖 Continuous Integration

  • all of:
    • check-success = build
    • check-success = lint
    • check-success = test
    • any of:
      • check-success = test-broken-links
      • label = ignore-broken-links
    • any of:
      • check-success=Cloudflare Pages
      • -head-repo-full-name~=^Mergifyio/

🟢 Enforce conventional commit

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

  • title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert|ui)(?:\(.+\))?:

🟢 📕 PR description

  • body ~= (?ms:.{48,})

🟢 🚦 Auto-queue

When all merge protections are satisfied, this pull request will be queued automatically.

@mergify mergify Bot requested a review from a team June 30, 2026 15:22
@jd jd marked this pull request as ready for review June 30, 2026 15:38
Corrections surfaced by the new docs-gap-analysis skill against the last
90 days of changelog entries:

- configuration/conditions.mdx: document `{{ author }}` as a built-in
  condition value, and add prose for the `check-cancelled` and `scope`
  condition attributes (previously only rendered in the generated table)
- ci-insights/auto-retry.mdx: rules are now scoped per repository via the
  repository selector (the per-rule `repository` condition is no longer
  needed); mention the "Test your log patterns" tester in the rule builder
- merge-queue/github-rulesets.mdx: document that Mergify honors GitHub's
  "Require approval of the most recent push" by auto-injecting the matching
  condition
- merge-queue/scopes.mdx: fix broken cross-link
  (/merge-queue/parallel-scopes -> /merge-queue/queue-modes#limiting-concurrency-per-scope)

Verified with the proofread pipeline (style/technical/structure/consistency)
and `pnpm check` (0 errors). The stale `allow_checks_interruption` default in
merge-queue/priority.mdx is intentionally NOT changed: the schema still says
default true while the changelog says false, so it needs product confirmation.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Change-Id: I57ed4284abe888c205fbbb07953d7d76d8e335b1
@jd jd force-pushed the devs/jd/worktree-skill/add-docs-authoring-maintenance-skills--e17e7c54 branch from b30cb9a to c8189f5 Compare June 30, 2026 15:44
@jd jd force-pushed the devs/jd/worktree-skill/close-gaps-found-docs-gap-analysis--57ed4284 branch from 5979274 to 5c5f5ef Compare June 30, 2026 15:44
@jd

jd commented Jun 30, 2026

Copy link
Copy Markdown
Member Author

Revision history

# Type Changes Reason Date
1 initial 5979274 2026-06-30 15:44 UTC
2 rebase 5979274 → 5c5f5ef (rebase only) 2026-06-30 15:44 UTC

@mergify mergify Bot had a problem deploying to Mergify Merge Protections June 30, 2026 15:45 Failure
@mergify mergify Bot requested a review from a team June 30, 2026 20:22
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