Skip to content

Add Developer Tools section and restructure AWS docs#691

Open
peter-smith-phd wants to merge 1 commit into
mainfrom
doc-234-restructure-developer-tools
Open

Add Developer Tools section and restructure AWS docs#691
peter-smith-phd wants to merge 1 commit into
mainfrom
doc-234-restructure-developer-tools

Conversation

@peter-smith-phd
Copy link
Copy Markdown
Contributor

@peter-smith-phd peter-smith-phd commented Jun 4, 2026

LocalStack's developer tools are how teams get full value out of the emulator, but until now the documentation was scattered across the Capabilities and Tooling top-level sections, sitting next to one-time admin and install material. This made it hard to identify what developers should be using, versus what administrators should be using.

This PR introduces a dedicated Developer Tools section, placed immediately after Connecting, that collects everything a developer uses in their regular workflow. Admin and configuration material stays behind: Capabilities is renamed to Configuration, the leftover Tooling pages move under it, and the Tooling section is removed. The Configuration section is intentionally left as a grab-bag for now and will be cleaned up in a later restructuring effort.

Key changes

  • New Developer Tools section (wrench icon) with an Overview page and the following entries: Running LocalStack (LocalStack CLI, lstk, LocalStack MCP Server), Snapshots, App Inspector, Chaos Engineering, Security Testing, Lambda Tools, AWS Replicator, and Cloud Sandbox.
  • Two new overview pages authored from scratch: the Developer Tools overview and the Running LocalStack sub-section overview, each with section cards.
  • State Management renamed to Snapshots and moved into Developer Tools; App Inspector pulled out of the Web App section into its own top-level entry.
  • Capabilities renamed to Configuration, with the remaining Tooling pages (LocalStack SDKs, Extensions, DNS Server, Testing Utils, LocalStack Docker Extension, LocalSurf) relocated under it. The Configuration overview page was rewritten for its new contents.
  • Tooling section removed entirely, including its overview page.
  • Pages moved with git mv so history is preserved; all internal hyperlinks across the docs updated to the new locations.
  • Redirects updated in public/_redirects: existing redirect targets repointed to the new URLs (one hop), plus new old→new redirects for every moved page.
  • Icons and landing page: added Developer Tools and Configuration mappings in icon-loader.js; updated the AWS landing page cards.

Verified with npm run build: 391 pages build and the link validator reports all internal links valid.

Completes DOC-234

Collect the day-to-day developer tools (CLI, lstk, MCP server, snapshots,
app inspector, chaos engineering, security testing, lambda tools, replicator,
cloud sandbox) into a new top-level Developer Tools section. Rename Capabilities
to Configuration, move the remaining Tooling pages under it, remove the Tooling
section, and update icons, links, and redirects accordingly.

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

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 46c4b6c
Status: ✅  Deploy successful!
Preview URL: https://341e86e1.localstack-docs.pages.dev
Branch Preview URL: https://doc-234-restructure-develope.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.

2 participants