Skip to content

docs(stacks,integrations,cli,api): fix CLI and integration inaccuracies - #12210

Merged
mergify[bot] merged 1 commit into
mainfrom
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-cli-integration-inaccuracies--959e8efb
Jul 27, 2026
Merged

docs(stacks,integrations,cli,api): fix CLI and integration inaccuracies#12210
mergify[bot] merged 1 commit into
mainfrom
devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-cli-integration-inaccuracies--959e8efb

Conversation

@jd

@jd jd commented Jul 26, 2026

Copy link
Copy Markdown
Member

First docs-health audit pass over the stacks, integrations, CLI, and API
pages. Accuracy fixes verified against the CLI source and schema, the
setup-cli action, and the engine:

  • cli/usage: mergify --token <command> does not exist (no global
    --token); corrected to mergify <command> --token
  • integrations/dependabot: "Dependabot provides specific labels" was
    wrong; they are Mergify condition attributes computed from PR metadata
  • stacks/compare/graphite: "MCP bundled with CLI" was wrong; the CLI
    ships agent skills, no MCP server
  • api/usage: the Mergify CLI link pointed at /stacks instead of
    /cli/usage; product names capitalized (CI Insights, Workflow
    Automation)
  • stacks/compare pages: "queue freeze" link text renamed to "queue
    pause" (it links to /merge-queue/pause; freeze is a different feature)

Every mergify stack command and flag, the git-config keys, install
claims, API endpoints/scopes, and all Datadog metric names were verified
against source; the rest were accurate.

Plus a conservative style pass per the proofread rubrics: banned words,
em dashes, promotional filler, grammar ("Developers Tools", "many
functionalities requires", etc.).

Part of the first manual docs-health audit (MRGFY-8212).

Co-Authored-By: Claude Fable 5 noreply@anthropic.com

Depends-On: #12209

@jd

jd commented Jul 26, 2026

Copy link
Copy Markdown
Member Author

This pull request is part of a Mergify stack:

# Pull Request Link
1 docs(configuration): fix reference accuracy and style drift #12205
2 docs(workflow): fix action reference accuracy and style drift #12206
3 docs(merge-queue): fix accuracy drift and style across the section #12207
4 docs(commands,merge-protections,migrate): fix broken examples and style #12208
5 docs(ci-insights,test-insights,monorepo-ci): fix wrong commands and claims #12209
6 docs(stacks,integrations,cli,api): fix CLI and integration inaccuracies #12210 👈
7 docs(enterprise,misc): fix inverted Redis TLS instructions and style #12211

@mergify

mergify Bot commented Jul 26, 2026

Copy link
Copy Markdown
Contributor

Merge Protections

🟢 All 7 merge protections satisfied — ready to merge.

Show 7 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/

🟢 👀 Review Requirements

  • any of:
    • #approved-reviews-by >= 2
    • author = dependabot[bot]
    • author = mergify-ci-bot

🟢 Enforce conventional commit

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

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

🟢 🔎 Reviews

  • #changes-requested-reviews-by = 0
  • #review-requested = 0
  • #review-threads-unresolved = 0

🟢 📕 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 July 26, 2026 08:17
@jd
jd marked this pull request as ready for review July 26, 2026 08:20
First docs-health audit pass over the stacks, integrations, CLI, and API
pages. Accuracy fixes verified against the CLI source and schema, the
setup-cli action, and the engine:

- cli/usage: `mergify --token <command>` does not exist (no global
  --token); corrected to `mergify <command> --token`
- integrations/dependabot: "Dependabot provides specific labels" was
  wrong; they are Mergify condition attributes computed from PR metadata
- stacks/compare/graphite: "MCP bundled with CLI" was wrong; the CLI
  ships agent skills, no MCP server
- api/usage: the Mergify CLI link pointed at /stacks instead of
  /cli/usage; product names capitalized (CI Insights, Workflow
  Automation)
- stacks/compare pages: "queue freeze" link text renamed to "queue
  pause" (it links to /merge-queue/pause; freeze is a different feature)

Every `mergify stack` command and flag, the git-config keys, install
claims, API endpoints/scopes, and all Datadog metric names were verified
against source; the rest were accurate.

Plus a conservative style pass per the proofread rubrics: banned words,
em dashes, promotional filler, grammar ("Developers Tools", "many
functionalities requires", etc.).

Part of the first manual docs-health audit (MRGFY-8212).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Change-Id: I959e8efb567e65386fa6ee6317d479b7b2649085
@jd
jd force-pushed the devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-wrong-cmds-claims--6653e900 branch from fe438fe to c084a27 Compare July 26, 2026 08:23
@jd
jd force-pushed the devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-cli-integration-inaccuracies--959e8efb branch from 5c0e76c to 679c26e Compare July 26, 2026 08:23
@jd

jd commented Jul 26, 2026

Copy link
Copy Markdown
Member Author

Revision history

# Type Changes Reason Date
1 initial 5c0e76c 2026-07-26 08:22 UTC
2 rebase 5c0e76c → 679c26e (rebase only) 2026-07-26 08:22 UTC

@mergify
mergify Bot had a problem deploying to Mergify Merge Protections July 26, 2026 08:23 Failure
JulianMaurin
JulianMaurin previously approved these changes Jul 27, 2026
@mergify
mergify Bot requested a review from a team July 27, 2026 11:31
@mergify
mergify Bot force-pushed the devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-wrong-cmds-claims--6653e900 branch from c084a27 to 81b0627 Compare July 27, 2026 11:32
Base automatically changed from devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-wrong-cmds-claims--6653e900 to main July 27, 2026 12:08
@mergify
mergify Bot dismissed JulianMaurin’s stale review July 27, 2026 12:08

The base branch was changed.

@mergify
mergify Bot force-pushed the devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-cli-integration-inaccuracies--959e8efb branch from 679c26e to 796274a Compare July 27, 2026 12:08
@mergify
mergify Bot deployed to Mergify Merge Protections July 27, 2026 12:09 Active
@mergify
mergify Bot requested a review from a team July 27, 2026 12:44
@mergify

mergify Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Merge Queue Status

This pull request spent 2 minutes 31 seconds in the queue, including 2 minutes 9 seconds running CI.

Required conditions to merge

@mergify mergify Bot added the queued label Jul 27, 2026
@mergify
mergify Bot merged commit 83b7aa5 into main Jul 27, 2026
10 checks passed
@mergify
mergify Bot deleted the devs/jd/jd/mrgfy-8212-docs-health-non-deterministic-audit-loop-style-accuracy/fix-cli-integration-inaccuracies--959e8efb branch July 27, 2026 14:10
@mergify mergify Bot removed the queued label Jul 27, 2026
mergify Bot pushed a commit that referenced this pull request Jul 27, 2026
…12211)

First docs-health audit pass over the enterprise section and top-level
pages. The critical accuracy fix, verified against the engine:

- enterprise/installation: both Redis TLS bullets said "use `redis://`
  instead of `rediss://`", which is backwards; the engine only enables
  TLS (and the self-signed escape hatch) for the `rediss://` scheme.
  Anyone following the docs got a non-TLS connection.

Also fixed, verified: garbled installer step wording, "at leas"/stray-ß
typos, "DNS over HTTPS" misphrasing (reads as the DoH protocol),
inconsistent example domain, billing grammar ("a annual license",
"12-months period"), and a full-site URL converted to an internal link.
All MERGIFYENGINE_* env vars, endpoints, and admin commands on these
pages were verified against the monorepo.

Plus a conservative style pass per the proofread rubrics: emojis removed
from prose, em dashes, throat-clearing intros on enterprise/billing/
support, callout indentation, banned words. Compliance, pricing, and SLA
claims were deliberately left untouched (flagged in the audit report
instead).

Part of the first manual docs-health audit (MRGFY-8212).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Depends-On: #12210
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.

4 participants