Bifurcate Advanced > Platform docs into other relevant sections

[adityaoberai]

What does this PR do?

Breaks up the catch-all Advanced → Platform docs section, which had grown into an unrelated mix of billing, API integration, security, and product-specific pages. Its contents are redistributed into three focused homes plus the relevant product sections, so each page now lives where users actually look for it. Every moved URL is covered by a redirect, and all internal doc links, navigation, and overview pages are updated to match.

New sections

• /docs/advanced/billing — new landing page + layout, covering plans, add-ons, SLAs, and billing policies.
• /docs/advanced/api-integration — new landing page + layout (also absorbs the old /docs/advanced/integration stub), covering events, webhooks, and the API error reference.

Pages moved

From …/advanced/platform/…	To
events, webhooks, response-codes, error-handling, release-policy	…/advanced/api-integration/…
billing → payments, free, pro, scale, enterprise, oss, compute, phone-otp, image-transformations, database-reads-and-writes, support-sla, uptime-sla, fair-use-policy, abuse, refund-policy	…/advanced/billing/…
roles, permissions, rate-limits, api-keys, dev-keys, environment-variables	…/advanced/security/…
message-templates	…/products/auth/…
custom-domains	…/products/network/custom-domains
shortcuts	…/tooling/command-center/shortcuts

Supporting updates

• Redirects: added redirects from every old /docs/advanced/platform/* path (and /docs/advanced/platform → /docs, /docs/advanced/integration → /docs/advanced/api-integration) to its new home; repointed existing redirects (/docs/keys, /docs/permissions, /docs/events, /docs/webhooks, etc.).
• Navigation: updated the docs sidebar and the Billing / API Integration / Security / Auth / Network / Command Center layouts to reflect the new structure.
• Internal links: rewrote all /docs/** content links, partials, components, the init page, llms.txt generators, and STYLE.md to the new paths.
• Overview pages: Security overview now surfaces the relocated Access control (Permissions, Rate limits, API keys, Dev keys) and Configuration (Environment variables) pages as cards.
• Incidental fixes on the touched Security overview: corrected the TLS card (was pointing at the HTTPS page) and added a missing MFA card so the card grid matches the sidebar.

Test Plan

Visit all relevant sections in /docs

Related PRs and Issues

N/A

Have you read the Contributing Guidelines on issues?

Yes

[appwrite]

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)

Site	Status	Logs	Preview	QR
website 69d7f2670014e24571ca	Building	View Logs	Preview URL

Website (appwrite/website)

Project ID: 684969cb000a2f6c0a02

Sites (1)

Site	Status	Logs	Preview	QR
website 68496a17000f03d62013	Building	View Logs	Preview URL

---

Tip

Silent mode disables those chatty PR comments if you prefer peace and quiet

[eldadfux]

I feel like this page could be a container for simply just APIs and we can drop the integration part. Maybe have some overview of the different APIs types Appwrite support and why we offer different types. We can still link to the different API types directly from the main navigation like we do now.

[eldadfux]

We can even use the existing /docs/apis path.

[adityaoberai]

I had thought about that but right now the APIs section is structured to contain info on the different protocols.

This broadens the scope of the section. If that is alright, I can directly shift these there.

[eldadfux]

I think we can, it really make sense the more I look at the content. We can have a sub category for protocols and around them all the common things like response models or events, links structure will also work really well this way.

[adityaoberai]

I've gotten a version of this ready, need a review

[atharvadeosthale]

@greptile-app review?

[greptile-apps]

Greptile Summary

This PR splits the monolithic Advanced → Platform docs section into focused homes: a new /docs/advanced/billing section, relocated events/webhooks/error pages under /docs/apis, expanded Security coverage, and per-product placements for message templates, custom domains, and shortcuts. Every removed URL is covered by a redirect, all internal doc links are updated, and overview pages are revised to match.

• New sections and layouts: Billing overview + layout, APIs overview page, (events-and-errors) layout group, standalone Release Policy layout, all with nav trees matching the pages present.
• Security overview hardening: fixes a pre-existing bug where the TLS card linked to the HTTPS page, adds a missing MFA card, and surfaces the newly relocated Access control pages (Permissions, Roles, Rate limits, API keys, Dev keys, Environment variables).
• Incidental env var docs: functions-env-vars.md and sites-env-vars.md are expanded with APPWRITE_DEPLOYMENT_TYPE, APPWRITE_SITE_ID, APPWRITE_SITE_API_KEY, and the full suite of APPWRITE_VCS_* metadata variables.

Confidence Score: 5/5

This is a documentation-only restructuring; no application logic is changed, and every former URL has a redirect entry pointing to a verified existing page.

All 26 new redirects were verified against the corresponding page files that are created or moved in this PR. A grep of the entire /docs tree confirms zero residual advanced/platform links in documentation content. The Sidebar and each sub-section layout are internally consistent. The env var table additions are additive and do not alter existing rows. Two pre-existing bugs in the Security overview (wrong TLS href, missing MFA card) are also corrected here.

No files require special attention. The redirect table in src/redirects.json is the highest-risk file in any URL restructuring but has been reviewed and all targets exist.

Important Files Changed

Filename	Overview
src/redirects.json	Adds 26 redirects covering every removed platform/* path and repoints existing short-form redirects; all targets map to existing pages.
src/routes/docs/Sidebar.svelte	Replaces Platform entry with Billing; adds APIs Overview, Events & Errors, and Release policy nav items; adds isParent to Command Center. Consistent with new route layout.
src/routes/docs/advanced/billing/+layout.svelte	New layout for billing section; nav entries match all new billing/* pages exactly.
src/routes/docs/advanced/billing/+page.markdoc	New billing overview page; all card hrefs match the billing layout nav entries.
src/routes/docs/advanced/security/+layout.svelte	Adds Access control and Configuration groups (permissions, roles, rate-limits, api-keys, dev-keys, environment-variables) to the security sidebar.
src/routes/docs/advanced/security/+page.markdoc	Adds Access control and Configuration sections; fixes TLS card (was pointing to HTTPS); adds missing MFA card.
src/routes/docs/apis/(events-and-errors)/+layout.svelte	New layout grouping events, webhooks, response codes, and error handling under /docs/apis; parent breadcrumb points to /docs (consistent with other section layouts).
src/routes/docs/apis/(overview)/+page.markdoc	New APIs overview page at /docs/apis linking to REST, GraphQL, Realtime, Events, Webhooks, and error pages.
src/partials/functions-env-vars.md	Adds APPWRITE_DEPLOYMENT_TYPE and all APPWRITE_VCS_* variables to the functions environment variable table; accompanying note clarifies VCS fields are empty for non-Git deployments.
src/partials/sites-env-vars.md	Mirrors the functions-env-vars update for sites; adds APPWRITE_SITE_ID, APPWRITE_SITE_API_KEY, and the full set of VCS metadata variables.
src/routes/docs/advanced/platform/+layout.svelte	Deleted; all nav items redistributed to billing, security, and apis layouts; redirects cover all former paths.
src/routes/docs/advanced/release-policy/+page.markdoc	Moved from platform/release-policy to advanced/release-policy with a redirect and a new standalone layout using the top-level sidebar.
src/routes/llms.txt/+server.ts	Removes the /docs/advanced/integration stub-page skip filter since that stub is deleted; no other changes.

_{Reviews (1): Last reviewed commit: "Format env var tables" | Re-trigger Greptile}