initial commit, add getting started to docs. update mkdocs and menu navigation

Author: hjgraca

docs/core/logging-v2.md

@@ -1,5 +1,5 @@
 ---
-title: Logging V2
+title: Logging v2
 description: Core utility
 ---
 
@@ -25,6 +25,14 @@ The logging utility provides a Lambda optimized logger with output structured as
   interface
 * Support for message templates `{}` and `{@}` for structured logging
 
+## Breaking changes from v1 (dependency updates)
+
+| Change | Before (v1.x) | After (v2.0) | Migration Action |
+|--------|---------------|--------------|-----------------|
+| Amazon.Lambda.Core | 2.2.0|2.5.0 | dotnet add package Amazon.Lambda.Core |
+| Amazon.Lambda.Serialization.SystemTextJson | 2.4.3 | 2.4.4 | dotnet add package Amazon.Lambda.Serialization.SystemTextJson |
+| Microsoft.Extensions.DependencyInjection | 8.0.0 | 8.0.1 | dotnet add package Microsoft.Extensions.DependencyInjection |
+
 ## Installation
 
 Powertools for AWS Lambda (.NET) are available as NuGet packages. You can install the packages
@@ -1467,10 +1475,13 @@ You can change where the `Logger` will output its logs by setting the `LogOutput
 We also provide a helper class for tests `TestLoggerOutput` or you can provider your own implementation of `IConsoleWrapper`.
 
 ```csharp
-// Using TestLoggerOutput
-options.LogOutput = new TestLoggerOutput();
-// Custom console output for testing
-options.LogOutput = new TestConsoleWrapper();
+Logger.Configure(options =>
+{
+    // Using TestLoggerOutput
+    options.LogOutput = new TestLoggerOutput();
+    // Custom console output for testing
+    options.LogOutput = new TestConsoleWrapper();
+});
 
 // Example implementation for testing:
 public class TestConsoleWrapper : IConsoleWrapper
@@ -1483,6 +1494,32 @@ public class TestConsoleWrapper : IConsoleWrapper
     }
 }
 ```
+```csharp
+// Test example
+[Fact]
+public void When_Setting_Service_Should_Update_Key()
+{
+    // Arrange
+    var consoleOut = new TestLoggerOutput();
+    Logger.Configure(options =>
+    {
+        options.LogOutput = consoleOut;
+    });
+    
+    // Act
+    _testHandlers.HandlerService();
+
+    // Assert
+
+    var st = consoleOut.ToString();
+
+    Assert.Contains("\"level\":\"Information\"", st);
+    Assert.Contains("\"service\":\"test\"", st);
+    Assert.Contains("\"name\":\"AWS.Lambda.Powertools.Logging.Logger\"", st);
+    Assert.Contains("\"message\":\"test\"", st);
+}
+```
+
 ### ILogger
 
 If you are using ILogger interface you can inject the logger in a dedicated constructor for your Lambda function and thus you can mock your ILogger instance.

docs/core/logging.md

@@ -1,10 +1,19 @@
 ---
-title: Logging
+title: Logging v1
 description: Core utility
 ---
 
+!!! warning
+    Version 1.x.x will continue to be supported until **end of July 2025** for critical bug fixes and security updates in very exceptional cases where you cannot update to v2, but no new features will be added to this version. 
+    
+    We recommend you upgrade to the latest version.
+
+    The latest version is available at [Logging v2](https://docs.powertools.aws.dev/lambda/dotnet/core/logging-v2/).
+    
+
 The logging utility provides a Lambda optimized logger with output structured as JSON.
 
+
 ## Key features
 
 * Capture key fields from Lambda context, cold start and structures logging output as JSON

docs/core/metrics.md

@@ -1,8 +1,14 @@
 ---
-title: Metrics
+title: Metrics v1
 description: Core utility
 ---
 
+!!! warning
+    Version 1.x.x will continue to be supported **until end of October 2025** for bug fixes and security updates, but no new features will be added to this version. We recommend you upgrade to the latest version.
+
+    The latest version is available at [Metrics v2](https://docs.powertools.aws.dev/lambda/dotnet/core/metrics-v2/).
+
+
 Metrics creates custom metrics asynchronously by logging metrics to standard output following [Amazon CloudWatch Embedded Metric Format (EMF)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format.html).
 
 These metrics can be visualized through [Amazon CloudWatch Console](https://aws.amazon.com/cloudwatch/).

docs/getting-started/idempotency/aot.md

@@ -0,0 +1,4 @@
+---
+title: Simple Logging
+description: Getting started with Logging
+---