Skip to content

fix: update billing docs with new billing interval information#672

Open
tamalchowdhury wants to merge 2 commits intomainfrom
tamal/update/billing-interval-update
Open

fix: update billing docs with new billing interval information#672
tamalchowdhury wants to merge 2 commits intomainfrom
tamal/update/billing-interval-update

Conversation

@tamalchowdhury
Copy link
Collaborator

@tamalchowdhury tamalchowdhury commented Feb 28, 2026

Description (required)

Related issues & labels (optional)

  • Closes #
  • Suggested label:

Summary by CodeRabbit

  • Documentation
    • Clarified billing limitations: custom billing intervals are not supported; fixed charges are limited to daily, weekly, monthly, or yearly.
    • Added guidance for offering a single fixed charge per plan as an annual option with a custom yearly price.
    • Updated plan creation, pricing-model, and concept docs and workflows to include billing interval selection, annual-offer semantics, terminology, and small wording/formatting improvements.

@tamalchowdhury tamalchowdhury requested a review from a team as a code owner February 28, 2026 14:47
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 28, 2026

Walkthrough

This PR updates six billing docs to replace monthly-only subscription wording with configurable billing intervals (daily, weekly, monthly, yearly), adds an optional annual pricing offering for fixed charges, and introduces/clarifies related billing terminology.

Changes

Cohort / File(s) Summary
About Billing
src/content/docs/billing/about-billing/about-billing.mdx, src/content/docs/billing/about-billing/billing-concepts-terms.mdx, src/content/docs/billing/about-billing/kinde-billing-model.mdx
Replaced "monthly-only" limitation with precise limitation text: custom billing intervals not supported; fixed charges limited to Day/Week/Month/Year. Added/expanded billing terminology (Plan group, Pricing model, Tiered pricing, Unit price, Usage-based price) and an option to offer one fixed charge annually at a yearly price.
Manage Plans
src/content/docs/billing/manage-plans/about-plans.mdx, src/content/docs/billing/manage-plans/create-plans.mdx
Removed monthly-only limitation. Expanded Fixed charges flow to include Billing interval (Day/Week/Month/Year), an optional "Offer as annual" price field (one fixed charge per plan allowed), updated step order and asides about reuse and Stripe sync.
Pricing Models
src/content/docs/billing/pricing/pricing-models.mdx
Updated flat-rate guidance to select a billing interval (daily, weekly, monthly, yearly) and optionally offer an annual price for a fixed charge; removed a hard-coded monthly example and generalized wording.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐇 I hopped through docs with pen in paw,
Days, weeks, months and years I saw,
One annual ticket twinkling bright,
Fixed charges dancing in new light,
A rabbit's cheer for billing made right. 🎉

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check ✅ Passed The title accurately reflects the main change across all modified files: updating billing documentation to document support for custom billing intervals (daily, weekly, monthly, yearly) and related billing features.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
  • 📝 Generate docstrings (stacked PR)
  • 📝 Generate docstrings (commit on current branch)
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch tamal/update/billing-interval-update

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (3)
src/content/docs/billing/manage-plans/about-plans.mdx (1)

82-82: Consider clarifying the yearly pricing format in the table.

The table shows $ 20 / month or yearly but doesn't indicate that yearly billing uses a custom annual price (as documented elsewhere). This could confuse readers who expect the yearly price to simply be $20 × 12.

✏️ Suggested improvement
-| Subscription        | $ 20 / month or yearly       | Fixed charge              |
+| Subscription        | $20/month (or custom yearly) | Fixed charge              |
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/content/docs/billing/manage-plans/about-plans.mdx` at line 82, Update the
table cell that currently reads " $ 20 / month or yearly" to explicitly indicate
that yearly billing uses a custom annual price rather than simply 12× the
monthly rate; for example, change the Subscription column entry (the row with
heading "Subscription") to something like "$20 / month or custom annual price
for yearly billing" or "$20 / month or a custom yearly price (not simply
$20×12)" so readers understand the yearly charge is documented elsewhere as a
custom annual price.
src/content/docs/billing/pricing/pricing-models.mdx (1)

33-33: Minor: Avoid repetitive "yearly" in the same sentence.

The phrase "custom yearly price when the customer selects yearly billing" uses "yearly" twice in close proximity, which reads awkwardly.

✏️ Suggested rewording
-In Kinde, create a **Fixed charge** and call it something like `Subscription fee`. Choose a **billing interval** (daily, weekly, monthly, or yearly) and set the price. You can optionally **offer as annual**—bill the charge once per year at a custom yearly price when the customer selects yearly billing (only one fixed charge per plan can be offered as annual). Re-use the charge in each plan and change the price and line item description as needed.
+In Kinde, create a **Fixed charge** and call it something like `Subscription fee`. Choose a **billing interval** (daily, weekly, monthly, or yearly) and set the price. You can optionally **offer as annual**—bill the charge once per year at a custom price when the customer selects annual billing (only one fixed charge per plan can be offered as annual). Re-use the charge in each plan and change the price and line item description as needed.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/content/docs/billing/pricing/pricing-models.mdx` at line 33, The sentence
in the pricing-models.mdx diff repeats "yearly" ("custom yearly price when the
customer selects yearly billing"); replace that phrase with a non-repetitive
alternative such as "custom annual price when the customer selects yearly
billing" (or "custom yearly price when the customer selects annual billing") to
remove the duplicate word while preserving meaning; update the sentence in the
same paragraph where the Fixed charge / Subscription fee description appears.
src/content/docs/billing/manage-plans/create-plans.mdx (1)

84-84: Minor: Same "yearly" repetition as in pricing-models.mdx.

Consider rewording to avoid using "yearly" twice in close proximity.

✏️ Suggested rewording
-A fixed charge is a recurring charge such as base price or subscription fee. You can set **billing intervals** (daily, weekly, monthly, or yearly) and optionally **offer the charge as annual** with a custom yearly price when customers choose yearly billing.
+A fixed charge is a recurring charge such as base price or subscription fee. You can set **billing intervals** (daily, weekly, monthly, or yearly) and optionally **offer the charge as annual** with a custom price when customers choose annual billing.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/content/docs/billing/manage-plans/create-plans.mdx` at line 84, The
sentence "A fixed charge is a recurring charge..." repeats "yearly" twice; edit
that sentence in create-plans.mdx to reword the second occurrence for clarity
(for example change "when customers choose yearly billing" to "when customers
choose annual billing" or "when customers opt for an annual plan") so it no
longer uses "yearly" twice while preserving the explanation of billing intervals
and the option to offer a custom yearly price; update the phrase near "billing
intervals" / "offer the charge as annual" accordingly.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@src/content/docs/billing/about-billing/about-billing.mdx`:
- Around line 53-55: The bullet under the "Known limitations" section is
ambiguous about custom billing intervals; update the copy so it clearly states
whether custom intervals are supported or restricted. Either move the sentence
into the supported-features list and rephrase to: "Fixed charges support daily,
weekly, monthly, and yearly intervals (annual pricing available); custom
intervals such as quarterly are not supported," OR keep it under Known
limitations and reword to explicitly say: "Limitation: only fixed charges
support daily, weekly, monthly, and yearly intervals; custom intervals (e.g.,
quarterly) are not supported." Edit the line referencing "Custom billing
intervals (e.g., quarterly)..." accordingly and ensure consistency with
surrounding headings ("Known limitations" / supported features).

---

Nitpick comments:
In `@src/content/docs/billing/manage-plans/about-plans.mdx`:
- Line 82: Update the table cell that currently reads " $ 20 / month or yearly"
to explicitly indicate that yearly billing uses a custom annual price rather
than simply 12× the monthly rate; for example, change the Subscription column
entry (the row with heading "Subscription") to something like "$20 / month or
custom annual price for yearly billing" or "$20 / month or a custom yearly price
(not simply $20×12)" so readers understand the yearly charge is documented
elsewhere as a custom annual price.

In `@src/content/docs/billing/manage-plans/create-plans.mdx`:
- Line 84: The sentence "A fixed charge is a recurring charge..." repeats
"yearly" twice; edit that sentence in create-plans.mdx to reword the second
occurrence for clarity (for example change "when customers choose yearly
billing" to "when customers choose annual billing" or "when customers opt for an
annual plan") so it no longer uses "yearly" twice while preserving the
explanation of billing intervals and the option to offer a custom yearly price;
update the phrase near "billing intervals" / "offer the charge as annual"
accordingly.

In `@src/content/docs/billing/pricing/pricing-models.mdx`:
- Line 33: The sentence in the pricing-models.mdx diff repeats "yearly" ("custom
yearly price when the customer selects yearly billing"); replace that phrase
with a non-repetitive alternative such as "custom annual price when the customer
selects yearly billing" (or "custom yearly price when the customer selects
annual billing") to remove the duplicate word while preserving meaning; update
the sentence in the same paragraph where the Fixed charge / Subscription fee
description appears.

ℹ️ Review info

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2a5f111 and bbacb21.

📒 Files selected for processing (6)
  • src/content/docs/billing/about-billing/about-billing.mdx
  • src/content/docs/billing/about-billing/billing-concepts-terms.mdx
  • src/content/docs/billing/about-billing/kinde-billing-model.mdx
  • src/content/docs/billing/manage-plans/about-plans.mdx
  • src/content/docs/billing/manage-plans/create-plans.mdx
  • src/content/docs/billing/pricing/pricing-models.mdx

@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Feb 28, 2026

Deploying kinde-docs-preview with  Cloudflare Pages  Cloudflare Pages

Latest commit: e24e7cb
Status: ✅  Deploy successful!
Preview URL: https://5d15f1f8.kinde-docs-preview.pages.dev
Branch Preview URL: https://tamal-update-billing-interva.kinde-docs-preview.pages.dev

View logs

@tamalchowdhury tamalchowdhury changed the title fix: custom billing interval update fix: update billing docs with new billing interval information Feb 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant