Skip to content

docs: Promote cloud guides into a Concepts section#581

Merged
developerjamiu merged 5 commits into
mainfrom
docs/cloud-concepts-from-guides
Jun 9, 2026
Merged

docs: Promote cloud guides into a Concepts section#581
developerjamiu merged 5 commits into
mainfrom
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

@Swiftaxe Swiftaxe left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Everything looks good!

Only two things to consider:

  • What decides the orders inside each folder. We should have some logic rule to follow. (Like alphabetical or demand or else)

  • We should consider moving away from filename-ordering in the Cloud docs, before we get too entrenched in it. Ordering a page can lead to massive file changes when the docs grow.

Base automatically changed from docs/cloud-deployments-concept to main June 9, 2026 09:59

@Swiftaxe Swiftaxe left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@developerjamiu developerjamiu self-assigned this Jun 9, 2026
@developerjamiu developerjamiu added documentation Improvements or additions to documentation enhancement New feature or request labels Jun 9, 2026
@developerjamiu developerjamiu merged commit 371f19a into main Jun 9, 2026
4 checks passed
@developerjamiu developerjamiu deleted the docs/cloud-concepts-from-guides branch June 9, 2026 11:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants