Skip to content

docs(billing): show the Plan page as it renders today - #13151

Draft
jd wants to merge 1 commit into
mainfrom
devs/jd/jd/reshoot-billing-plan/show-plan-page-renders-today--ecd3b939
Draft

jd wants to merge 1 commit into
mainfrom
devs/jd/jd/reshoot-billing-plan/show-plan-page-renders-today--ecd3b939

Conversation

@jd

@jd jd commented Oct 2, 2026

Copy link
Copy Markdown
Member

The "Checking Current Usage" section used to embed a Plan screenshot that
showed the organization settings as a horizontal tab strip (Plan | Billing |
CI Insights). The dashboard moved those to a left sidebar, so the picture
contradicted the Settings → Plan prose above it. The stale image was then
swapped for a hand-written example table and deleted, which removed the wrong
picture but left the section describing a page the reader cannot see.

This puts a fresh capture back in place of the invented table. It shows what
the prose describes: each product with its repository count and its
active-contributor count, with free products and paid products in separate
tables, and the Committed and On-demand Usage columns a billing manager sees
on an annual subscription.

The prose changes follow the page as it renders now: the products are split
across a Free and a Paid table, On-demand Usage is a column of the paid table,
"third column" now names the column it means (the product column has no
header), and the on-premise note says what is unavailable.

Captured headless at 1440x900, retina 2x, light theme, from the
mergify-sandbox org, and cropped to the content pane so the settings sidebar
cannot make it stale again.

Fixes Mergifyio/ci-bot#395

Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com

The "Checking Current Usage" section used to embed a Plan screenshot that
showed the organization settings as a horizontal tab strip (Plan | Billing |
CI Insights). The dashboard moved those to a left sidebar, so the picture
contradicted the **Settings → Plan** prose above it. The stale image was then
swapped for a hand-written example table and deleted, which removed the wrong
picture but left the section describing a page the reader cannot see.

This puts a fresh capture back in place of the invented table. It shows what
the prose describes: each product with its repository count and its
active-contributor count, with free products and paid products in separate
tables, and the Committed and On-demand Usage columns a billing manager sees
on an annual subscription.

The prose changes follow the page as it renders now: the products are split
across a Free and a Paid table, On-demand Usage is a column of the paid table,
"third column" now names the column it means (the product column has no
header), and the on-premise note says what is unavailable.

Captured headless at 1440x900, retina 2x, light theme, from the
mergify-sandbox org, and cropped to the content pane so the settings sidebar
cannot make it stale again.

Fixes Mergifyio/ci-bot#395

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Change-Id: Iecd3b939813a283a6a066b13dd54a634a168408d
Copilot AI balanced review requested due to automatic review settings October 2, 2026 18:03
@mergify
mergify Bot had a problem deploying to Mergify Merge Protections October 2, 2026 18:03 Failure
@jd

jd commented Oct 2, 2026

Copy link
Copy Markdown
Member Author

One thing to check before this leaves draft: the Paid rows come from the sandbox org's own subscription, which is a legacy per-product plan. That's why each row has an Upgrade plan button. The committed figures work out to $144 per seat per year (about $12 a month), and the public pricing page lists $21 a month, or $18 billed yearly. So the screenshot puts a price on the billing page that a reader could take for the list price.

If that's not acceptable, there are two ways out:

  • Crop to the Free table only. The prose about the paid columns stays, but it loses its picture.
  • Move the sandbox onto a current plan and reshoot.

The Free half and the column layout are accurate either way.

@mergify

mergify Bot commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

Merge Protections

🔴 2 of 5 protections blocking · waiting on 👀 reviews

Protection Waiting on
🔴 👀 Review Requirements 👀 reviews
🔴 🔎 Reviews 👀 reviews
🟢 Enforce conventional commit —
🟢 📕 PR description —
🟢 🚦 Auto-queue —

🔴 👀 Review Requirements

Waiting for

  • #approved-reviews-by >= 1
This rule is failing.
  • any of:
    • #approved-reviews-by >= 1
    • author = dependabot[bot]
    • author = renovate[bot]
    • all of:
      • author = mergify-ci-bot
      • -head ~= ^docs-agent/

🔴 🔎 Reviews

Waiting for

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

Show 3 satisfied protections

🟢 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)(?:\(.+\))?!?:

🟢 📕 PR description

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

🟢 🚦 Auto-queue

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

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot review overview

🟡 Changes recommended

The referenced screenshot asset is missing, which will break the docs build.

Review effort: Balanced
Findings: 1 High severity

Open (1)
What changed in this PR

Restores current Plan-page imagery and updates billing guidance to match the dashboard.

Changes:

  • Adds a Plan screenshot reference.
  • Clarifies Free/Paid tables and usage columns.
  • Clarifies on-premise availability.
File Description
src/​content/​docs/​billing.mdx Updates Plan-page documentation and embeds its screenshot.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread src/content/docs/billing.mdx
@mergify
mergify Bot requested a review from a team October 2, 2026 18:06

This branch had an error being deployed

1 failed deployment
Mergify Merge Protections — 9a250e3d Deployed Oct 2, 2026 by mergify[bot]
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