Skip to content

DOC-58 Restructure docs into Connecting section#633

Draft
peter-smith-phd wants to merge 1 commit intomainfrom
doc-58-docs-restructuring-connecting-to-localstack
Draft

DOC-58 Restructure docs into Connecting section#633
peter-smith-phd wants to merge 1 commit intomainfrom
doc-58-docs-restructuring-connecting-to-localstack

Conversation

@peter-smith-phd
Copy link
Copy Markdown
Contributor

Summary

Linear: DOC-58

Adds a new top-level Connecting section that groups the docs a user needs to point an existing AWS application at LocalStack:

  • AWS CLI — moved from integrations/aws-native-tools/
  • AWS SDKs — moved from integrations/aws-sdks/; page titles renamed to AWS's official names (e.g. "AWS SDK for .NET")
  • Infrastructure as Code — Terraform, AWS SAM, AWS CDK, Serverless Framework, Pulumi, AWS Chalice, AWS Copilot CLI, Crossplane, Cloud Custodian, Former2 (sidebar order matches that)
  • LocalStack Console — Resource Browser and Stack Overview (Instance Management stays in capabilities/web-app/)
  • LocalStack Toolkit (IDEs) — VS Code Toolkit moved from tooling/

Other changes:

  • Sidebar entry "Connecting" gets a new plug icon (src/assets/images/plug.svg + .plug-icon CSS) so it's visually distinct from "Integrations".
  • New Overview pages for the section and four of its subsections, using <SectionCards> modelled on aws/capabilities/index.mdx.
  • Now-empty Integrations groups (AWS SDKs, AWS Native Tools, Infrastructure as Code) removed from the sidebar; their orphan index.md files deleted.
  • 301 redirects added for every relocated URL; legacy /user-guide/... redirects retargeted directly at the new locations (no chained hops).
  • Internal cross-references across services, tutorials, and Snowflake docs updated to the new paths.

Test plan

  • npm run build passes locally (377 pages, all internal links valid).
  • Sidebar shows Connecting between Sample Apps and Capabilities, with subsections in the agreed order.
  • Plug icon appears next to "Connecting" in the left nav.
  • Spot-check redirects: hit a few old URLs (/aws/integrations/aws-sdks/, /aws/integrations/aws-native-tools/aws-cli/, /aws/tooling/vscode-extension/) and confirm they 301 to the new paths.
  • Spot-check legacy /user-guide/... redirects still resolve in one hop.
  • Confirm Instance Management is back under Capabilities → LocalStack Web App.

🤖 Generated with Claude Code

Add a new top-level "Connecting" section grouping the docs needed to
point an existing AWS application at LocalStack — AWS CLI, AWS SDKs,
Infrastructure as Code, LocalStack Console, and the LocalStack
Toolkit (IDEs) — with redirects, updated cross-references, and new
Overview pages.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 1f64053
Status: ✅  Deploy successful!
Preview URL: https://6e76c01d.localstack-docs.pages.dev
Branch Preview URL: https://doc-58-docs-restructuring-co.localstack-docs.pages.dev

View logs

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