Skip to content

update: Database service management reuse - PART 2#1752

Merged
wojcik-dorota merged 3 commits into
mainfrom
DOC-1948-db-part-2-service-management-reuse
Jul 15, 2026
Merged

update: Database service management reuse - PART 2#1752
wojcik-dorota merged 3 commits into
mainfrom
DOC-1948-db-part-2-service-management-reuse

Conversation

@wojcik-dorota

@wojcik-dorota wojcik-dorota commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator

https://aiven.atlassian.net/browse/DOC-1948

Created per-service articles from the 7 component groups — only where the service supports the feature (verified against aiven-core), with service-specific info, placed in the correct IA sections.

Feature → article | Section | Services:

  • Change service plan | Scaling and performance | all 6
  • Prepare for high load | Scaling and performance | all 6
  • Scale disk storage | Scaling and performance | PG, MySQL, OpenSearch, Valkey
  • Maintenance and updates (updates + window) | Maintenance and lifecycle | all 6
  • Change cloud or region | Service management | all 6 (PG reuses its existing page)
  • Track restore progress | Backups and migration (Metrics: Maintenance) | all 6
  • Backup to another region (BTAR) | Backups and migration | all except Metrics
  • Memory + out-of-memory | Scaling and performance | new pages for OpenSearch/Grafana/Metrics; merged into existing memory pages for PG/MySQL/Valkey

Also:

  • 6 new section overview pages (OpenSearch Scaling; Grafana Scaling/Maintenance/Backups; Metrics Scaling/Maintenance), wired as category landing pages — new sections were created for OpenSearch/Grafana/Metrics that didn't have them.
  • Moved PG's existing migrate-cloud-region into Service management (its content already uses the change-cloud-console include).

Three includes needed fixes to build (they were provided incomplete/latent-buggy):

  • maintenance-updates.md and maintenance-window-instructions.md — added the missing ConsoleLabel/Tabs/TabItem imports (they used the components without importing them).
  • service-memory-limits.md — the ${ RAM - overhead }$ line was parsed by MDX as a JS expression (RAM is not defined, broke the build). Rewrote it as inline code (usable memory = RAM - overhead).

Finally, for Metrics (no backups/fork), I put Track restore progress under Maintenance and lifecycle rather than creating a "Backups and migration" section that would be misleading.

@wojcik-dorota wojcik-dorota self-assigned this Jul 9, 2026
@wojcik-dorota wojcik-dorota requested a review from a team as a code owner July 9, 2026 11:45
@wojcik-dorota wojcik-dorota marked this pull request as draft July 9, 2026 11:47
@wojcik-dorota wojcik-dorota changed the title update: Database service management reuse - restructuring update: Database service management reuse - PART 2 Jul 9, 2026
@wojcik-dorota wojcik-dorota marked this pull request as ready for review July 9, 2026 13:48
@wojcik-dorota wojcik-dorota marked this pull request as draft July 9, 2026 13:48
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 9, 2026

Copy link
Copy Markdown

Deploying aiven-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: d1199d6
Status: ✅  Deploy successful!
Preview URL: https://fbc5d41d.aiven-docs.pages.dev
Branch Preview URL: https://doc-1948-db-part-2-service-m.aiven-docs.pages.dev

View logs

@wojcik-dorota wojcik-dorota requested a review from UX-Irene July 10, 2026 11:49
@wojcik-dorota wojcik-dorota marked this pull request as ready for review July 10, 2026 11:49
@UX-Irene

Copy link
Copy Markdown

Great work Dorota, your all done!
Last part we need to discuss with the team is if the EOL should be on the Service level or not. Perhaps this is more a generic section somewhere.

@UX-Irene UX-Irene left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Perfect, it all looks consistent and works well. thanks for all this effort to make the Docs navigation more consistent.

@wojcik-dorota wojcik-dorota merged commit 4f9f3f6 into main Jul 15, 2026
5 checks passed
@wojcik-dorota wojcik-dorota deleted the DOC-1948-db-part-2-service-management-reuse branch July 15, 2026 10:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants