Skip to content

docs: Promote cloud guides into a Concepts section#581

Open
developerjamiu wants to merge 1 commit into
docs/cloud-deployments-conceptfrom
docs/cloud-concepts-from-guides
Open

docs: Promote cloud guides into a Concepts section#581
developerjamiu wants to merge 1 commit into
docs/cloud-deployments-conceptfrom
docs/cloud-concepts-from-guides

Conversation

@developerjamiu
Copy link
Copy Markdown
Contributor

Summary

  • Adds a Concepts section to the Cloud docs by promoting the Logs, Passwords, Custom domains, and Database guides into concept pages, and introducing a Deployments concept that didn't exist before.
  • Each concept covers overview, operations, and constraints in one page, so readers find one canonical page per capability instead of scattered how-tos.
  • Removes the four corresponding guides plus the orphaned reference/02-logging.md; old URLs redirect to the new concept URLs via docusaurus.config.js.

Test plan

  • npm run build passes locally (verified).
  • Navigate the Cloud sidebar and confirm the new Concepts section shows: Deployments, Logs, Passwords/secrets/env vars, Custom domains, Database.
  • Open each concept page and confirm operations, code examples, and cross-links resolve.
  • Visit the old URLs (/cloud/guides/logs, /cloud/guides/passwords, /cloud/guides/custom-domains, /cloud/guides/database, /cloud/reference/logging) and confirm each redirects to the matching concept.
  • Spot-check that Access the database content still surfaces (now under the Database concept) including the GUI client suggestions.

Out of scope

🤖 Generated with Claude Code

@developerjamiu developerjamiu changed the base branch from main to docs/cloud-deployments-concept June 5, 2026 11:16
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.

1 participant