docs: update docs with latest blogs and features, update deps (#802)

Co-authored-by: Ran Isenberg <ran.isenberg@ranthebuilder.cloud>

Author: ran-isenberg

.github/workflows/main-serverless-service.yml

@@ -71,7 +71,7 @@ jobs:
         env:
           ENVIRONMENT: staging # Custom environment variable
       - name: Codecov
-        uses: codecov/codecov-action@f30e4959ba63075080d4f7f90cacc18d9f3fafd7 # v4.0.0
+        uses: codecov/codecov-action@e0b68c6749509c5f83f984dd99a76a1c1a231044 # v4.0.1
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: ./coverage.xml

.github/workflows/pr-serverless-service.yml

@@ -99,7 +99,7 @@ jobs:
       - name: Code coverage tests
         run: make coverage-tests
       - name: Codecov
-        uses: codecov/codecov-action@f30e4959ba63075080d4f7f90cacc18d9f3fafd7 # v4.0.0
+        uses: codecov/codecov-action@e0b68c6749509c5f83f984dd99a76a1c1a231044 # v4.0.1
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: ./coverage.xml

.pre-commit-config.yaml

@@ -26,7 +26,7 @@ repos:
         exclude: "^(?!helpers/)"
   - repo: https://github.com/astral-sh/ruff-pre-commit
     # Ruff version.
-    rev: v0.2.0
+    rev: v0.2.2
     hooks:
       # Run the Ruff linter.
       - id: ruff

README.md

@@ -66,6 +66,12 @@ Starting a Serverless service can be overwhelming. You need to figure out many q
 
 This project aims to reduce cognitive load and answer these questions for you by providing a skeleton Python Serverless service template that implements best practices for AWS Lambda, Serverless CI/CD, and AWS CDK in one template project.
 
+## Concepts
+
+I spoke at AWS re:invent 2023 with Heitor Lessa, Chief Architect of Powertools for AWS Lambda about the concepts I implemented in this project.
+
+[![Watch the video](https://img.youtube.com/vi/52W3Qyg242Y/maxresdefault.jpg)](https://www.youtube.com/watch?v=52W3Qyg242Y)
+
 ### Serverless Service - The Order service
 
 - This project provides a working orders service where customers can create orders of items.
@@ -93,8 +99,9 @@ This project aims to reduce cognitive load and answer these questions for you by
 - REST API protected by WAF with four AWS managed rules in production deployment
 - CloudWatch dashboards - High level and low level including CloudWatch alarms
 - Unit, infrastructure, security, integration and end to end tests.
-- Automatically generated OpenAPI endpoint: /swagger with Pydnatic schemas for both requests and responses
+- Automatically generated OpenAPI endpoint: /swagger with Pydantic schemas for both requests and responses
 - CI swagger protection - fails the PR if your swagger JSON file (stored at docs/swagger/openapi.json) is out of date
+- Automated protection against API breaking changes
 
 
 ## CDK Deployment
@@ -121,6 +128,7 @@ The utilities cover multiple aspect of a production-ready service, including:
 - [CDK Best practices](https://github.com/ran-isenberg/aws-lambda-handler-cookbook)
 - [Serverless Monitoring](https://www.ranthebuilder.cloud/post/how-to-effortlessly-monitor-serverless-applications-with-cloudwatch-part-one)
 - [API Idempotency](https://www.ranthebuilder.cloud/post/serverless-api-idempotency-with-aws-lambda-powertools-and-cdk)
+- [Serverless OpenAPI Documentation with AWS Powertools](https://www.ranthebuilder.cloud/post/serverless-open-api-documentation-with-aws-powertools)
 
 ## Getting started
 Head over to the complete project documentation pages at GitHub pages at [https://ran-isenberg.github.io/aws-lambda-handler-cookbook](https://ran-isenberg.github.io/aws-lambda-handler-cookbook/)

docs/index.md

@@ -31,6 +31,12 @@ This project aims to reduce cognitive load and answer these questions for you by
 
 <img alt="alt_text" src="./media/monitoring_design.png" />
 
+## Concepts
+
+I spoke at AWS re:invent 2023 with Heitor Lessa, Chief Architect of Powertools for AWS Lambda about the concepts I implemented in this project.
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/52W3Qyg242Y" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+
 ### **Features**
 
 - Python Serverless service with a recommended file structure.
@@ -46,7 +52,8 @@ This project aims to reduce cognitive load and answer these questions for you by
 - Idempotent API
 - REST API protected by WAF with four AWS managed rules in production deployment
 - Unit, infrastructure, security, integration and E2E tests.
-- Automatically generated OpenAPI endpoint: /swagger with Pydnatic schemas for both requests and responses
+- Automatically generated OpenAPI endpoint: /swagger with Pydantic schemas for both requests and responses
+- Automated protection against API breaking changes
 
 The GitHub template project can be found at [https://github.com/ran-isenberg/aws-lambda-handler-cookbook](https://github.com/ran-isenberg/aws-lambda-handler-cookbook){:target="_blank" rel="noopener"}.
 
@@ -67,6 +74,7 @@ The utilities cover multiple aspects of a production-ready service, including:
 - [**Serverless Monitoring**](https://www.ranthebuilder.cloud/post/how-to-effortlessly-monitor-serverless-applications-with-cloudwatch-part-one)
 - [**API Idempotency**](https://www.ranthebuilder.cloud/post/serverless-api-idempotency-with-aws-lambda-powertools-and-cdk){:target="_blank" rel="noopener"}
 - [**Learn How to Write AWS Lambda Functions with Three Architecture Layers**](https://www.ranthebuilder.cloud/post/learn-how-to-write-aws-lambda-functions-with-architecture-layers){:target="_blank" rel="noopener"}
+- [**Serverless OpenAPI Documentation with AWS Powertools**](https://www.ranthebuilder.cloud/post/serverless-open-api-documentation-with-aws-powertools){:target="_blank" rel="noopener"}
 
 While the code examples are written in Python, the principles are valid to any supported AWS Lambda handler programming language.
 

package-lock.json

@@ -1,5 +1,5 @@
 {
     "dependencies": {
-        "aws-cdk": "2.126.0"
+        "aws-cdk": "2.128.0"
     }
 }