docs(cloud): restructure the Cloud tab and add verified pricing pages

[Mandalorian-Wang]

What this does

Two things: restructures the BoxLite Cloud tab so every navigation root is a summary plus an index, and adds the pricing documentation that was missing entirely.

Cloud goes from 12 pages to 24, still two levels deep.

Navigation roots are now summaries, not monoliths

Root	Before	After
cloud/index	115	45
cloud/boxes	299	41
cloud/volumes	531	39
cloud/network	461	44
cloud/pricing	281	45

Each root now carries a value proposition, the single warning most likely to bite, an In this section card group, and a "Which page do I want?" intent table. Everything else moved to task-shaped siblings.

The splits were scoped by measuring section sizes, not page length:

network:  one section was 410/462 lines (89%)
volumes:  two sections were 357/532
pricing:  one section was 177/282
boxes:    63 / 35 / 83 / 67  — no dominant section

cloud/boxes was therefore split by topic rather than to relieve bloat, and only after checking that its six inbound anchor links could be repointed.

New structure:

Getting started  index      → vs-opensource, quickstart, api-keys
Boxes            boxes      → images, sizes, lifecycle, from-code
Volumes          volumes    → mount-a-volume, volume-operations, data-across-boxes, reference
Network          network    → tunnels, serve-http, port-forwarding, raw-streams, network-policy
Pricing          pricing    → box-costs, cost-controls, plans, billing

No route that had shipped was deleted or renamed, so no redirects are needed. Anchors that moved were repointed across 10 files.

Pricing documentation

There was none. The old billing page listed plan tiers but never stated a single unit price — the only price signal was "the New Box dialog reports PRICE PER HOUR", which outsources the most-asked question to the product itself.

Rates come from Commerce's anonymous /usage-prices, not from the repo's test fixtures (which happen to carry the same values — a trap worth naming):

Resource	Rate
vCPU	$0.0504 / vCPU-hour
Memory	$0.0144 / GiB-hour
Disk	$0.00018 / GiB-hour

New pages:

• cloud/box-costs — the formula, per-hour/per-month costs for every preset, and which hours are counted: compute billing stops when a stop is requested, disk billing stops when deletion is requested, and there is no minimum duration or hour-rounding.
• cloud/cost-controls — auto_stop / auto_delete, in Python, Node, and Go. The default configuration stops paying for compute automatically and pays for disk forever; this page closes that loop.
• cloud/plans — plan tiers plus the break-even points ($20 → Starter, $161 → Pro, $601 → Max) and the constant saving past quota ($11 / $101 / $401 per month).
• cloud/billing — rewritten as account operations. Adds automatic reload, which the old page never mentioned, and explains why the "available" balance drifts downward with no payment taken (it is the ongoing balance).

The headline fact the old page omitted: a stopped box is still billed for its disk until it is deleted. BOX_STATES_BILLING_DISK_ONLY = [STOPPING, STOPPED].

Correctness fix

cloud/boxes claimed that a box created over REST gets auto_stop=0 and "keeps running until you stop it, and paying for it is your responsibility."

It does not. The SDK omits the field when unset (#[serde(skip_serializing_if = "Option::is_none")]), and the platform resolves the absence to DEFAULT_AUTO_STOP_SECONDS = 900:

// apps/api/src/box/services/box.service.ts:1453
const autoStop = input.autoStop ?? DEFAULT_AUTO_STOP_SECONDS

The unwrap_or(0) that the earlier claim rested on is client-side validation, and its own comment says so: "validate only the caller's requested policy — not the server's auto_stop".

This mattered in the dangerous direction: the page told readers a long unattended job would keep running, while the same page warned elsewhere that such a job is stopped at 15 minutes. Corrected in three places, found by grepping for the class rather than the instance.

Volume CRUD

cloud/volume-operations is now an actual CRUD page. Before this change:

• rt.volumes.get() had no runnable code anywhere in the docs
• list() appeared only incidentally, inside a deletion demo
• the headings were What the SDK does not tell you and Deletion is asynchronous — a reader looking for "how do I list my volumes" would never find them

It now runs create → list → get → delete in one script, in Python, Node, and REST, and documents that there is no update operation: create / list / get / remove is the entire surface, verified by grepping for update|rename|patch|resize|set_name across the Rust core, the Python bindings, and the Node contracts.

Also

• Removed a dev-environment hostname that had been used to show the rate list was checkable. It leaked internal naming and pointed readers at a non-production host.
• Deleted cloud/index's runnable script, which duplicated cloud/quickstart and cloud/vs-opensource.
• Deleted cloud/network's outbound section, which duplicated the fuller one on cloud/network-policy.
• Renamed preview-urls → serve-http: "preview URL" is a distinct platform concept that network-policy owns, and network-policy says so explicitly.
• llms.txt is now generated from docs.json and page frontmatter, with --check wired into CI. It was hand-maintained and had drifted to five dead links and no Cloud section.

Verification

Check	Result
mint broken-links	no broken links found
scripts/lint-docs.py	180 pages, no soft promises
Internal links and anchors	101 pages, all resolve
gen-llms-txt.py --check	up to date
All 24 Cloud routes	200 locally
Go example	go vet clean against the SDK
Volume API claims	re-checked against origin/main after confirming the checkout was current

Not verified

The Starter / Pro / Max price, quota, and concurrency figures on cloud/plans. Commerce's /plan catalog requires authentication (401; a nonexistent route returns 404, so the distinction is real). Those three rows carry over from the previously published page, and the break-even table is derived from them. Worth a glance in the console before merging.

🤖 Generated with Claude Code

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: f84fac16-cfb0-4f8c-9873-051987fd9e15

---

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.}