docs: add dedicated billing limits and alerts page

[kathiekiwi]

New /billing-limits page covering the full billing limits feature : the three limit options (plan / custom / no limit), billing alerts (% of limit or dollar thresholds), what happens when the limit is reached, the recovery flow, the soft-limits caveat, and the billing limit marker on the Usage page.

• How to reduce your spend: the old billing limits section trimmed to a short pointer at the new page
• Common problems: new "Runs queued because a billing limit was reached" entry alongside the concurrency causes of stuck QUEUED runs
• Limits: a note clarifying that a billing limit is a setting you control, not a platform limit

[changeset-bot]

⚠️ No Changeset found

Latest commit: 23a2f39

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coderabbitai]

Walkthrough

This pull request adds a new docs/billing-limits.mdx page covering billing limits and alerts, including setup, alert thresholds, enforcement, resumption, and usage tracking. It also adds the page to docs/docs.json navigation and updates docs/how-to-reduce-your-spend.mdx, docs/limits.mdx, and docs/troubleshooting.mdx to link to or reference the new page.

Changes

Cohort / File(s)	Summary
docs/billing-limits.mdx	New documentation page for billing limits and alerts
docs/docs.json	Added billing-limits to dashboard navigation
docs/how-to-reduce-your-spend.mdx	Replaced detailed section with a link to billing limits docs
docs/limits.mdx	Added note linking to billing limits docs
docs/troubleshooting.mdx	Added troubleshooting text for queued runs due to billing limits

Sequence Diagram(s)

Not applicable.

Related Issues: Not specified.

Related PRs: Not specified.

Suggested labels: documentation

Suggested reviewers: Not specified.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description is relevant, but it omits required template sections like Closes #, checklist, Testing, Changelog, and Screenshots headings.	Add the missing template sections: Closes #..., checklist, Testing steps, Changelog heading, and a Screenshots section.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title clearly summarizes the main change: adding a dedicated billing limits and alerts page.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/billing-limits

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.