Restructure some pages to create new "Connecting" section (#633)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: peter-smith-phd

astro.config.mjs

@@ -402,6 +402,48 @@ export default defineConfig({
               label: 'Sample Apps',
               slug: 'aws/sample-apps',
             },
+            {
+              label: 'Connecting',
+              collapsed: true,
+              items: [
+                {
+                  label: 'Overview',
+                  slug: 'aws/connecting',
+                },
+                {
+                  label: 'AWS CLI',
+                  slug: 'aws/connecting/aws-cli',
+                },
+                {
+                  label: 'AWS SDKs',
+                  autogenerate: {
+                    directory: '/aws/connecting/aws-sdks',
+                  },
+                  collapsed: true,
+                },
+                {
+                  label: 'Infrastructure as Code',
+                  autogenerate: {
+                    directory: '/aws/connecting/infrastructure-as-code',
+                  },
+                  collapsed: true,
+                },
+                {
+                  label: 'LocalStack Console',
+                  autogenerate: {
+                    directory: '/aws/connecting/console',
+                  },
+                  collapsed: true,
+                },
+                {
+                  label: 'IDE Extensions',
+                  autogenerate: {
+                    directory: '/aws/connecting/ides',
+                  },
+                  collapsed: true,
+                },
+              ],
+            },
             {
               label: 'Capabilities',
               collapsed: true,
@@ -514,10 +556,6 @@ export default defineConfig({
                   ],
                   collapsed: true,
                 },
-                {
-                  label: 'LocalStack Toolkit VS Code',
-                  slug: 'aws/tooling/vscode-extension',
-                },
                 {
                   label: 'Lambda Tools',
                   autogenerate: {
@@ -562,27 +600,6 @@ export default defineConfig({
                   },
                   collapsed: true,
                 },
-                {
-                  label: 'AWS SDKs',
-                  autogenerate: {
-                    directory: '/aws/integrations/aws-sdks',
-                  },
-                  collapsed: true,
-                },
-                {
-                  label: 'AWS Native Tools',
-                  autogenerate: {
-                    directory: '/aws/integrations/aws-native-tools',
-                  },
-                  collapsed: true,
-                },
-                {
-                  label: 'Infrastructure as Code',
-                  autogenerate: {
-                    directory: '/aws/integrations/infrastructure-as-code',
-                  },
-                  collapsed: true,
-                },
                 {
                   label: 'Containers',
                   autogenerate: {

public/_redirects

@@ -10,6 +10,7 @@
     Features: 'cube-icon',
     'Feature Coverage': 'buildings-icon',
     'Sample Apps': 'file-icon',
+    Connecting: 'plug-icon',
     Capabilities: 'starburst-icon',
     Tooling: 'wrench-icon',
     Integrations: 'connections-icon',

public/js/icon-loader.js

@@ -4,6 +4,10 @@ This directory contains scripts to help manage redirects for LocalStack's docs m
 - `docs.localstack.cloud` → `docs.localstack.cloud/aws/`
 - `snowflake.localstack.cloud` → `docs.localstack.cloud/snowflake/`
 
+⚠️ WARNING: The content of this directory was used during a migration project in 2025. There is no longer a need to
+follow these instructions or update any files in this directory. The scripts and instructions are provided here for
+historical reference only.
+
 ## 📁 Files Overview
 
 | File | Purpose |

scripts/redirects/README.md

@@ -65,7 +65,7 @@ To query the list of S3 buckets in the Ephemeral Instance, run the following com
 aws --endpoint-url=<EPHEMERAL_INSTANCE_ENDPOINT_URL> s3 ls
 ```
 
-You can also use integrations, such as [CDK](/aws/integrations/aws-native-tools/aws-cdk/), [SAM CLI](/aws/integrations/aws-native-tools/aws-sam/), and [Terraform](/aws/integrations/infrastructure-as-code/terraform/), to interact with the Ephemeral Instance.
+You can also use integrations, such as [CDK](/aws/connecting/infrastructure-as-code/aws-cdk/), [SAM CLI](/aws/connecting/infrastructure-as-code/aws-sam/), and [Terraform](/aws/connecting/infrastructure-as-code/terraform/), to interact with the Ephemeral Instance.
 In these integrations, you can change the `AWS_ENDPOINT_URL` environment variable to the endpoint URL of the Ephemeral Instance.
 
 ### View the Logs of the Ephemeral Instance

src/assets/images/plug.svg

@@ -20,7 +20,7 @@ LocalStack only binds to IPv4 addresses (e.g. `127.0.0.1`). Make sure you're not
 
 ## [Using the endpoint URL](/aws/capabilities/networking/accessing-endpoint-url)
 
-For example, setting the `endpoint_url` parameter with an [AWS SDK](/aws/integrations/aws-sdks/).
+For example, setting the `endpoint_url` parameter with an [AWS SDK](/aws/connecting/aws-sdks/).
 
 <CardGridLayout cards={[
   {

src/content/docs/aws/capabilities/cloud-sandbox/ephemeral-instances.md

@@ -109,7 +109,7 @@ Make sure to use this only for local testing, and never in production.
 ## Current Limitations
 
 - The mechanism to disable certificate validation for these requests is not currently functional with Go Lambdas.
-  To work around this issue, you'll need to manually set your endpoint when creating your AWS SDK client, as detailed in our documentation on the [Go AWS SDK](/aws/integrations/aws-sdks/go).
+  To work around this issue, you'll need to manually set your endpoint when creating your AWS SDK client, as detailed in our documentation on the [Go AWS SDK](/aws/connecting/aws-sdks/go).
 - Transparent Endpoint Injection does not work when code runs inside the LocalStack container. If you need to connect to LocalStack from within the container, here are a couple of alternative approaches:
   - Set the AWS_ENDPOINT_URL environment variable:
 Set `AWS_ENDPOINT_URL=http://localhost.localstack.cloud:4566`. This is the recommended approach as it directly points your AWS client to the LocalStack endpoint.

src/content/docs/aws/capabilities/networking/index.mdx

@@ -39,9 +39,9 @@ App Inspector runs against the LocalStack emulator, which monitors use of IAM po
 
 ## LocalStack Toolkit for VS Code
 
-App Inspector is built into the [LocalStack Toolkit for VS Code](/aws/tooling/vscode-extension), so you can trace operation flows and inspect payloads without leaving your editor. Once LocalStack is running, open the App Inspector panel directly in the LocalStack Toolkit extension to view operations and drill into service interactions.
+App Inspector is built into the [LocalStack Toolkit for VS Code](/aws/connecting/ides/vscode-extension), so you can trace operation flows and inspect payloads without leaving your editor. Once LocalStack is running, open the App Inspector panel directly in the LocalStack Toolkit extension to view operations and drill into service interactions.
 
-If you haven't set up the toolkit yet, see [LocalStack Toolkit for VS Code](/aws/tooling/vscode-extension) to get started.
+If you haven't set up the toolkit yet, see [LocalStack Toolkit for VS Code](/aws/connecting/ides/vscode-extension) to get started.
 
 ![App Inspector panel in the LocalStack Toolkit for VS Code showing a live event stream](/images/aws/app-inspector/app-inspector-vscode.png)
 

src/content/docs/aws/capabilities/networking/transparent-endpoint-injection.md

@@ -9,7 +9,7 @@ sidebar:
 ## Introduction
 
 The [AWS Command Line Interface (CLI)](https://aws.amazon.com/cli/) is a unified tool for creating and managing AWS services via a command line interface.
-All CLI commands applicable to services implemented within [LocalStack](/aws/integrations/aws-native-tools/aws-cli/) can be executed when operating against LocalStack.
+All CLI commands applicable to services implemented within [LocalStack](/aws/connecting/aws-cli/) can be executed when operating against LocalStack.
 
 You can use the AWS CLI with LocalStack using either of the following approaches: