docs: restructure Configuration & Integrations, add Organization & Admin#692
Merged
quetzalliwrites merged 17 commits intoJul 7, 2026
Conversation
Deploying localstack-docs with
|
| Latest commit: |
daf446b
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://fdec80d9.localstack-docs.pages.dev |
| Branch Preview URL: | https://dpx-493-docs-restructuring-c.localstack-docs.pages.dev |
peter-smith-phd
force-pushed
the
doc-234-restructure-developer-tools
branch
from
4ae6ef5 to
a680bd6
Compare
peter-smith-phd
force-pushed
the
dpx-493-docs-restructuring-configuration-integrations-and-team
branch
2 times, most recently
from
ce11526 to
205408a
Compare
peter-smith-phd
changed the title
peter-smith-phd
changed the base branch from
doc-234-restructure-developer-tools
to
main
peter-smith-phd
requested review from
HarshCasper,
aidehn,
alexrashed,
anisaoshafi,
baermat,
bentsku,
dfangl,
giograno,
joe4dev,
k-a-il,
nik-localstack,
pinzon,
quetzalliwrites,
remotesynth,
silv-io,
thrau and
viren-nadkarni
as code owners
Collaborator
|
Thanks @peter-smith-phd, taking a look this week 🙌🏽 |
quetzalliwrites
requested changes
Jun 24, 2026
quetzalliwrites
left a comment
quetzalliwrites
left a comment
Collaborator
There was a problem hiding this comment.
tyvm @peter-smith-phd, really enjoying teaming together lately on docs improvements 😸
As discussed in our call, adding feedback notes to the PR:
- change config to customization
- advanced install to other install
- reconsider the team workspace term... how about user management or team management (?)
- remove mention of Enterprise in left hand nav, approved by Colin
- let's move the Kubernetes sub-section (from old Enterprise section), Advanced Installation, and Integrations into the high level Config directory.
(We still want to update the directory name /config, for now we are thinking of /Customization)
Co-authored-by: Viren Nadkarni <viren.nadkarni@gmail.com>
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
…Docker executor (#666)
Co-authored-by: Ben Simon Hartung <42031100+bentsku@users.noreply.github.com>
Collaborator
hey @peter-smith-phd, instead of "team workspaces," let's name it |
Collaborator
|
@peter-smith-phd we're ready to move this forward!! Feedback, round 2:
|
Reorganize the former Capabilities and Enterprise areas into dedicated top-level sections: Configuration, Advanced Installation, CI Pipelines, Integrations, Team Workspaces, and Connecting. Overview pages now use section cards, and the AWS landing page and quickstart Next Steps reflect the new layout. public/_redirects maps the old paths to their new homes, and new colour icons matching the sidebar are added for the new sections. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…nstallations, and Integrations under it - Rename aws/configuration -> aws/customization - Move Kubernetes out of Advanced Installation into Customization, ahead of Networking - Rename remaining Advanced Installation to Other Installations and nest it under Customization - Move Integrations under Customization - Rename Team Workspaces to Organizations & Admin - Update sidebar nav, overview pages, redirects, and internal links accordingly - Scope sidebar icon matching to true top-level sections so Customization's nested Integrations no longer shows an icon, while Snowflake/Azure's top-level Integrations keep theirs Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
peter-smith-phd
force-pushed
the
dpx-493-docs-restructuring-configuration-integrations-and-team
branch
from
205408a to
67c4504
Compare
…kstart next steps - Rename TeamWorkspaces_Color.svg to OrganizationsAdmin_Color.svg to match the renamed section - Add a Customization entry to the quickstart Next Steps list Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…d in place Starting from origin/main's current _redirects, update only the destination side of existing rules that pointed at now-obsolete configuration/enterprise/integrations paths, preserving every source and its original position. Add redirects for main's current live aws/configuration/* pages (mirroring the equivalent aws/capabilities/* rules) since those pages move under this restructuring too. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…iases, double hops
Verified every path valid on main against the staging deployment and found:
- Missing mirror rules for main's live aws/enterprise/* and
aws/integrations/{containers,messaging,continuous-integration}/* pages
(only aws/configuration/* was mirrored previously) - these 404'd outright.
- Nine alias destinations that pointed at slugs that don't exist
(e.g. networking/created-resources, localstack-sdks/python,
web-app/workspace) - fixed to point at the real final pages.
- Nearly every internal destination lacked a trailing slash, causing an
extra 301/308 hop on top of the intended redirect - added trailing
slashes throughout so legacy redirects resolve in a single hop.
- Consolidated identity-subpath groups (networking, extensions,
localstack-sdks, kubernetes, sso, continuous-integration) into
wildcard rules instead of per-file entries, both removing redundancy
and reducing total rule count as a hedge against Cloudflare Pages'
reported (undocumented, sporadic) behavior of silently dropping
_redirects rules well under the documented 2,100-rule limit.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
quetzalliwrites
approved these changes
Jul 7, 2026
Collaborator
|
Almost ready to merge, you just got some conflicts. Can you fix the conflict showing in this file? Looks like the only thing pending! |
…cs-restructuring-configuration-integrations-and-team # Conflicts: # src/content/docs/aws/services/organizations.mdx
peter-smith-phd
changed the title
quetzalliwrites
deleted the
dpx-493-docs-restructuring-configuration-integrations-and-team
branch
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
This is the final phase of the AWS docs restructuring. The previous structure mixed emulator configuration, installation methods, CI usage, and account/admin tasks under generic section names, which made it hard for our different user groups to find what they need. This PR reorganizes the remaining content so the navigation maps to real user intent.
It builds on the already-restructured "Connecting" and "Developer Tools" sections.
Restructuring/planning was done by me, with help from Claude to update the files. I carefully reviewed every change, and made some updates by hand.
Major changes
capabilities/tree renamed toconfiguration/and then tocustomization/. This top-level section now contains:The Astro build passes with all internal links validated.