improv(docs): add getting started sections

Author: dreamorosi

docs/utilities/batch.md renamed to docs/features/batch.md

@@ -0,0 +1,8 @@
+---
+title: Features
+description: Features of Powertools for AWS Lambda
+---
+
+<!-- markdownlint-disable MD043 -->
+
+Stuff

docs/core/event-handler/api-gateway.md renamed to docs/features/event-handler/api-gateway.md

@@ -56,7 +56,7 @@ These settings will be used across all logs emitted:
 ???+ info
     When `POWERTOOLS_DEV` environment variable is present and set to `"true"` or `"1"`, Logger will pretty-print log messages for easier readability. We recommend to use this setting only when debugging on local environments.
 
-See all environment variables in the [Environment variables](../index.md/#environment-variables) section.
+See all environment variables in the [Environment variables](../index.md#environment-variables) section.
 Check API docs to learn more about [Logger constructor options](https://docs.powertools.aws.dev/lambda/typescript/latest/api/types/_aws_lambda_powertools_logger.types.ConstructorOptions.html){target="_blank"}.
 
 #### Example using AWS Serverless Application Model (SAM)

docs/utilities/idempotency.md renamed to docs/features/idempotency.md

@@ -413,7 +413,7 @@ You can use the `awsSdkV3Client` parameter via any of the available [Provider Cl
 | [DynamoDBProvider](#dynamodbprovider)   | `new DynamoDBClient();`       |
 
 ???+ question "When is this useful?"
-	Injecting a custom AWS SDK v3 client allows you to [apply tracing](../core/tracer.md#patching-aws-sdk-clients) or make unit/snapshot testing easier, including SDK customizations.
+	Injecting a custom AWS SDK v3 client allows you to [apply tracing](../features/tracer.md#patching-aws-sdk-clients) or make unit/snapshot testing easier, including SDK customizations.
 
 === "SSMProvider"
 	```typescript hl_lines="5 7"

docs/features/index.md

@@ -0,0 +1,8 @@
+---
+title: Getting Started
+description: A guide to using Powertools for AWS Lambda with TypeScript
+---
+
+<!-- markdownlint-disable MD043 -->
+
+Stuff

docs/utilities/jmespath.md renamed to docs/features/jmespath.md

@@ -0,0 +1,8 @@
+---
+title: Installation
+description: Installing Powertools for AWS Lambda
+---
+
+<!-- markdownlint-disable MD043 -->
+
+Stuff

docs/core/logger.md renamed to docs/features/logger.md

@@ -0,0 +1,8 @@
+---
+title: Lambda layers
+description: Using Powertools for AWS Lambda with Lambda layers
+---
+
+<!-- markdownlint-disable MD043 -->
+
+Stuff

docs/core/metrics.md renamed to docs/features/metrics.md

@@ -0,0 +1,8 @@
+---
+title: Navigating the Toolkit
+description: Getting to know the Powertools for AWS Lambda Toolkit
+---
+
+<!-- markdownlint-disable MD043 -->
+
+Stuff

docs/utilities/parameters.md renamed to docs/features/parameters.md

@@ -0,0 +1,8 @@
+---
+title: Typescript Settings
+description: Configuration settings for using Powertools with TypeScript
+---
+
+<!-- markdownlint-disable MD043 -->
+
+Stuff

docs/utilities/parser.md renamed to docs/features/parser.md

@@ -349,9 +349,9 @@ Core utilities such as Tracing, Logging, and Metrics will be available across al
 
 | Utility                                   | Description                                                                                                                                                       |
 | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [Tracer](./core/tracer.md)                | Decorators and utilities to trace Lambda function handlers, and both synchronous and asynchronous functions                                                       |
-| [Logger](./core/logger.md)                | Structured logging made easier, and a middleware to enrich structured logging with key Lambda context details                                                     |
-| [Metrics](./core/metrics.md)              | Custom Metrics created asynchronously via CloudWatch Embedded Metric Format (EMF)                                                                                 |
+| [Tracer](./features/tracer.md)                | Decorators and utilities to trace Lambda function handlers, and both synchronous and asynchronous functions                                                       |
+| [Logger](./features/logger.md)                | Structured logging made easier, and a middleware to enrich structured logging with key Lambda context details                                                     |
+| [Metrics](./features/metrics.md)              | Custom Metrics created asynchronously via CloudWatch Embedded Metric Format (EMF)                                                                                 |
 | [Parameters](./utilities/parameters.md)   | High-level functions to retrieve one or more parameters from AWS SSM Parameter Store, AWS Secrets Manager, AWS AppConfig, and Amazon DynamoDB                     |
 | [Idempotency](./utilities/idempotency.md) | Class method decorator, Middy middleware, and function wrapper to make your Lambda functions idempotent and prevent duplicate execution based on payload content. |
 | [Batch Processing](./utilities/batch.md)  | Utility to handle partial failures when processing batches from Amazon SQS, Amazon Kinesis Data Streams, and Amazon DynamoDB Streams.                             |

docs/core/tracer.md renamed to docs/features/tracer.md

@@ -22,7 +22,7 @@ V2 is focused on official support for ESM (ECMAScript modules). We've made other
 | **ESM support**       | Added ESM support via dual CommonJS and ESM bundling, enabling top-level `await` and tree-shaking.                             | -                    |
 | **Middy.js**          | Updated import path for Middy.js middlewares to leverage subpath exports - i.e. `@aws-lambda-powertools/tracer/middleware`.    | Yes                  |
 | **Types imports**     | Updated import path for TypeScript types to leverage subpath exports - i.e. `@aws-lambda-powertools/logger/types`.             | Yes                  |
-| **Logger**            | Changed [log sampling](./core/logger.md#sampling-debug-logs) to dynamically switch log level to `DEBUG` on a percentage of requests. | -                    |
+| **Logger**            | Changed [log sampling](./features/logger.md#sampling-debug-logs) to dynamically switch log level to `DEBUG` on a percentage of requests. | -                    |
 | **Logger**            | Updated [custom log formatter](#custom-log-formatter) to include standard as well as persistent keys.                          | Yes                  |
 | **Logger**            | Removed `ContextExamples` from `@aws-lambda-powertools/commons` package.                                                       | Yes                  |
 | **Logger and Tracer** | Removed deprecated `createLogger` and `createTracer` helper functions in favor of direct instantiation.                        | Yes                  |
@@ -198,7 +198,7 @@ Below is an example of how to configure your `.eslintrc.json` file:
 
 ### Log sampling
 
-!!! note "Disregard if you are not using the [log sampling feature](./core/logger.md#sampling-debug-logs)."
+!!! note "Disregard if you are not using the [log sampling feature](./features/logger.md#sampling-debug-logs)."
 
 In v1, log sampling implementation was inconsistent from other Powertools for AWS Lambda languages _(Python, .NET, and Java)_.
 
@@ -213,11 +213,11 @@ Logger `sampleRateValue` **continues** to determine the percentage of concurrent
 
 ### Custom log formatter
 
-!!! note "Disregard if you are not customizing log output with a [custom log formatter](./core/logger.md#custom-log-formatter)."
+!!! note "Disregard if you are not customizing log output with a [custom log formatter](./features/logger.md#custom-log-formatter)."
 
-In v1, `Logger` exposed the [standard](./core/logger.md#standard-structured-keys) as a single argument, _e.g., `formatAttributes(attributes: UnformattedAttributes)`_. It expected a plain object with keys and values you wanted in the final log output.
+In v1, `Logger` exposed the [standard](./features/logger.md#standard-structured-keys) as a single argument, _e.g., `formatAttributes(attributes: UnformattedAttributes)`_. It expected a plain object with keys and values you wanted in the final log output.
 
-In v2, you have more control over **standard** (`attributes`) and [**custom keys**](./core/logger.md#appending-additional-keys) (`additionalLogAttributes`) in the `formatAttributes` method. Also, you now return a `LogItem` object to increase type safety when defining the final log output.
+In v2, you have more control over **standard** (`attributes`) and [**custom keys**](./features/logger.md#appending-additional-keys) (`additionalLogAttributes`) in the `formatAttributes` method. Also, you now return a `LogItem` object to increase type safety when defining the final log output.
 
 === "Before"
 
@@ -305,7 +305,7 @@ In v2, you have more control over **standard** (`attributes`) and [**custom keys
     export { MyCompanyLogFormatter };
     ```
 
-    1. This new argument contains all [your custom keys](./core/logger.md#appending-additional-keys).
+    1. This new argument contains all [your custom keys](./features/logger.md#appending-additional-keys).
     2. `LogItem` is the new return object instead of a plain object.
     3. If you prefer adding at the initialization, use: <br/><br/> **`LogItem({persistentAttributes: additionalLogAttributes, attributes: baseAttributes})`**
 

docs/utilities/validation.md renamed to docs/features/validation.md

@@ -32,22 +32,29 @@ watch: [
 nav:
   - Homepage:
       - index.md
+      - Getting Started:
+          - getting-started/index.md
+          - Navigating the toolkit: getting-started/navigating-the-toolkit.md
+          - Installation: getting-started/installation.md
+          - TypeScript settings: getting-started/typescript-settings.md
+          - Lambda layers: getting-started/lambda-layers.md
+          - Workshop: https://s12d.com/powertools-for-aws-lambda-workshop" target="_blank
+      - Features:
+          - features/index.md 
+          - features/tracer.md
+          - features/logger.md
+          - features/metrics.md
+          - features/parameters.md
+          - features/idempotency.md
+          - features/batch.md
+          - features/jmespath.md
+          - features/parser.md
+          - features/validation.md
       - Changelog: changelog.md
       - Upgrade guide: upgrade.md
-      - We Made This (Community): we_made_this.md
-      - Workshop: https://s12d.com/powertools-for-aws-lambda-workshop" target="_blank
+      - Community Content: we_made_this.md
       - Roadmap: roadmap.md
-      - Features:
-          - core/tracer.md
-          - core/logger.md
-          - core/metrics.md
-          - utilities/parameters.md
-          - utilities/idempotency.md
-          - utilities/batch.md
-          - utilities/jmespath.md
-          - utilities/parser.md
-          - utilities/validation.md
-  - API reference: api"
+  - API reference: api/" target="_blank
   - Processes:
       - Roadmap: roadmap.md
       - Versioning policy: versioning.md