Skip to content

fix(docs): make Lago Cloud a reference page and remove funnel pages - #711

Merged
michaelponrajah merged 1 commit into
mainfrom
fix/remove-pages
Oct 17, 2026
Merged

michaelponrajah merged 1 commit into
mainfrom
fix/remove-pages

Conversation

@sarkissianraffi

Copy link
Copy Markdown
Contributor

Why

#707 moved Lago Cloud to the top of the Guide using thin evaluation pages and a sales-led Cloud page. People who landed there didn't find the docs they came for. Agents had nothing concrete to cite: no regions, URLs, security, or ingestion details. That kept Lago framed as "the self-hosted alternative".

What changed

Lago Cloud page (guide/lago-cloud.mdx), rewritten as a reference page:

  • US and EU regions with API base URLs, and region selection in the SDKs and CLI
  • What Lago runs and what your team configures
  • Managed ClickHouse and Kafka ingestion, connectors, VPC peering, 90-day retention
  • SOC 2 Type 2, AWS/KMS encryption, SSO, RBAC, audit logs, status page, Cloud terms
  • Get started steps and a Cloud vs self-hosted table
  • Every claim is sourced from existing docs (guide/security/soc.mdx, guide/events/usage-performances.mdx, developers.mdx, privacy.mdx)

Navigation

  • Get started holds only Lago Cloud and the Lago Self-hosted group
  • For agents moves to the AI Agents and MCP section
  • The homepage card is back to "Guide"

Removed, with redirects

Old page Redirects to
/guide/lago-cloud/self-serve-billing /guide/introduction/welcome-to-lago
/guide/lago-cloud/contract-billing /guide/plans/commitment
/guide/lago-cloud/finance-workflow /guide/invoicing/export

Other pages

  • Self-hosted overview: editions, install, a compatibility check before installing, operating links, and a pointer to Cloud
  • For agents: dropped the fictional "first result" table, the duplicated CLI/MCP setup (now links to those guides), and the marketing link
  • Removed links to the deleted pages from the FAQs, the invoicing overview, Welcome to Lago, and both llms.txt files

Checks

  • docs.json parses
  • mint broken-links: no broken links
  • Local mint dev: edited pages render, old URLs return 307 to their targets
  • mint validate isn't available in the installed CLI

Open question

The EU web app URL isn't documented in the repo, so it's left out of the regions table. Add it once confirmed.

🤖 Generated with Claude Code

Rewrite the Lago Cloud page with regions, API base URLs, usage
ingestion, security, and getting started. Get started now holds only
Lago Cloud and the self-hosted guides.

Delete the self-serve, contract, and finance-workflow pages and redirect
them to the canonical guides. Restore the homepage Guide card, flesh out
the self-hosted overview, trim For agents and move it to the AI section,
and clean inbound links and llms.txt indexes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Oct 17, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
lago-docs 🟢 Ready View Preview Oct 17, 2026, 2:11 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@michaelponrajah
michaelponrajah merged commit 1723b1d into main Oct 17, 2026
2 checks passed
@michaelponrajah
michaelponrajah deleted the fix/remove-pages branch October 17, 2026 09:46

This branch was successfully deployed

1 active deployment
staging — 55cc000c Deployed Oct 17, 2026 by mintlify[bot]
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.

3 participants