Update README

Author: Andrea Scuderi

README.md

@@ -16,7 +16,7 @@ Before we start, make sure you have these tools installed on your system:
 
   * [Docker](https://docs.docker.com/get-docker/)
   * [Visual Studio Code](https://code.visualstudio.com/download)
-  * [Visual Studio Code Remote - Containers Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
+  * [Visual Studio Code Dev Containers Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
   * [Docker Compose V2](https://docs.docker.com/compose/cli-command/)
   * It's also helpful to review the [official guide on configuring VS Code for Swift](https://www.swift.org/documentation/articles/getting-started-with-vscode-swift.html) and install Swift extension.
 
@@ -74,11 +74,13 @@ Let's make sure you can build and run locally first. Try running the debugger. T
 Now, let's tell VS Code how to build our container.
 
 1.  Open the command palette (**Cmd+Shift+P** / **Ctrl+Shift+P**).
-2.  Type and select **"Remote-Containers: Add Development Container Configuration Files..."**.
-3.  Choose **"Docker from Docker Compose"**.
-4.  Select **"Default Configuration"**.
-5.  When prompted to add features, select **"AWS CLI"**.
-6.  You can also select `.github/dependabot.yml` if you plan to use it.
+2.  Type and select **"Dev Containers: Add Dev Container Configuration Files..."**.
+3.  Choose **"Add configuration to workspace"**.
+4.  Choose **"Docker outside of Docker Compose"**.
+5.  Select **"latest"**.
+6.  Select the default options
+7.  When prompted to add features, select **"AWS CLI"**.
+8.  You can also select `.github/dependabot.yml` if you plan to use it.
 
 This will create a `.devcontainer` folder with a `devcontainer.json` and `docker-compose.yml` file.
 
@@ -176,6 +178,9 @@ services:
     security_opt:
       - seccomp:unconfined
 
+    # Use "forwardPorts" in **devcontainer.json** to forward an app port locally. 
+    # (Adding the "ports" property to this file will not forward from a Codespace.)
+
   # Add the localstack service
   localstack:
     image: localstack/localstack
@@ -200,7 +205,7 @@ RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
 Now for the magic.
 
 1.  Open the command palette (**Cmd+Shift+P** / **Ctrl+Shift+P**).
-2.  Type and select **"Remote-Containers: Rebuild and Reopen in Container"**.
+2.  Type and select **"Dev Containers: Rebuild and Reopen in Container"**.
 
 VS Code will now build your `Dockerfile`, start the `docker-compose` services (your Swift app and LocalStack), and reload the window, connecting you *inside* the `app` container. You'll know it worked when the bottom-left corner of VS Code shows "Dev Container: ...".
 
@@ -209,8 +214,9 @@ VS Code will now build your `Dockerfile`, start the `docker-compose` services (y
 Remember that old `launch.json` from Step 5? It's pointing to your *local* machine's paths, which don't exist inside the container. Let's fix it.
 
 1.  You can delete the old `.vscode/launch.json` file if you want, or just let this next step overwrite it.
-2.  Open the command palette (**Cmd+Shift+P** / **Ctrl+Shift+P**).
-3.  Type and select **"Swift: Generate Launch Configuration"**.
+2.  Select the `Package.swift` file in the Explorer to make it the active file.
+3.  Open the command palette (**Cmd+Shift+P** / **Ctrl+Shift+P**).
+4.  Type and select **"Swift: Generate Launch Configuration"**.
 
 This will create a *new* `launch.json` with the correct *container* paths (e.g., `/workspaces/SwiftInDevContainer/.build/debug/SwiftInDevContainer`).
 
@@ -224,19 +230,18 @@ First, update your `Package.swift` to include `soto-dynamodb`:
 
 ```swift
 // swift-tools-version: 6.2
+
 import PackageDescription
 
 let package = Package(
     name: "SwiftInDevContainer",
     dependencies: [
-        // Add Soto
         .package(url: "https://github.com/soto-project/soto.git", from: "7.0.0"),
     ],
     targets: [
         .executableTarget(
             name: "SwiftInDevContainer",
             dependencies: [
-                // Add the DynamoDB product
                 .product(name: "SotoDynamoDB", package: "soto"),
             ]
         ),
@@ -282,12 +287,12 @@ Create a `Makefile` in the root of your project:
 
 ```makefile
 localstack_create_dynamo_db_table:
-    aws --endpoint-url=http://localstack:4566 dynamodb create-table \
-        --table-name Breeze \
-        --attribute-definitions AttributeName=itemKey,AttributeType=S \
-        --key-schema AttributeName=itemKey,KeyType=HASH \
-        --billing-mode PAY_PER_REQUEST \
-        --region us-east-1
+	aws --endpoint-url=http://localstack:4566 dynamodb create-table \
+		--table-name Breeze \
+		--attribute-definitions AttributeName=itemKey,AttributeType=S \
+		--key-schema AttributeName=itemKey,KeyType=HASH \
+		--billing-mode PAY_PER_REQUEST \
+		--region us-east-1
 ```
 
 Now, in the VS Code terminal (which is *inside* the container), run the command: