Skip to content

Correct the Hosted billing specs' stale cross-reference, built Future rules, metrics row, and cron comment - #1435

Merged
nedtwigg merged 1 commit into
mainfrom
docs/hosted-billing-spec-drift
Oct 29, 2026
Merged

nedtwigg merged 1 commit into
mainfrom
docs/hosted-billing-spec-drift

Conversation

@dormouse-bot

Copy link
Copy Markdown
Collaborator

Docs-only: four places in the Hosted billing docs had drifted from the code that landed in #1407–#1426. Specs and lints pass locally (node scripts/spec-lint.mjs, node scripts/md-unwrap.mjs); no test is added because nothing here changes behavior.

  • docs/specs/pricing.md → "Checkout and entitlement": the "Cohorts close by count" bullet pointed at ("Checkout") for the rule that a full refund or finally reversed payment ends a subscription. That heading is now the ## Future section holding only Van Westendorp and licensing; the rule itself is two bullets down in the same section. Dropped the pointer.
  • docs/specs/pricing.md → Future "Renewal, cancellation, refund": removed two rules that are already built and stated above the fold — "No trial" (docs/specs/hosted.md → "Billing": "Never offer a trial or Managed Payments") and "A full refund revokes" (the "A full refund or a finally reversed payment ends the subscription it paid for" bullet). The remaining Future items are untouched; whether the 30-day guarantee and auto-renew bullets should also move above the fold is left to you.
  • docs/specs/hosted.md → Metrics: the subscription.canceled row read as counting every end, making subscription.refunded look like a subset. processEvent counts exactly one of the two, so the row now says "unless refunded". hosted.md's budget is re-baselined 6300 → 6350 for the two added words.
  • hosted/wrangler.jsonc: the cron comment described only the lapsed-subscription resync; resyncBilling also settles withdrawals, retries closure refunds, rereads open disputes, sends notices, and applies price changes.

pricing.md's cohort rule cited a "Checkout" heading that now holds only unbuilt work, and its Future list restated two rules already built (no trial, a full refund ends the subscription). hosted.md's Metrics table read as if a refunded end also counted as canceled; processEvent counts exactly one. The wrangler cron comment named only one of resyncBilling's passes.
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying mouseterm with  Cloudflare Pages  Cloudflare Pages

Latest commit: 6dc9d11
Status: ✅  Deploy successful!
Preview URL: https://847a506f.mouseterm.pages.dev
Branch Preview URL: https://docs-hosted-billing-spec-dri.mouseterm.pages.dev

View logs

@nedtwigg
nedtwigg merged commit 287ef2d into main Oct 29, 2026
12 checks passed
@nedtwigg
nedtwigg deleted the docs/hosted-billing-spec-drift branch October 29, 2026 23:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants