fix(docs): extract code snippets into dedicated python files and fix examples

Makefile

@@ -90,3 +90,23 @@ changelog:
 
 mypy:
 	poetry run mypy --pretty aws_lambda_powertools
+
+format-examples:
+	poetry run isort docs/shared
+	poetry run black docs/shared/*.py
+	poetry run isort docs/examples
+	poetry run black docs/examples/*/*.py
+	poetry run black docs/examples/*/*/*.py
+	poetry run black docs/examples/*/*/*/*.py
+	poetry run black docs/examples/*/*/*/*/*.py
+
+lint-examples:
+	poetry run python3 -m py_compile docs/shared/*.py
+	poetry run python3 -m py_compile docs/examples/*/*.py
+	poetry run python3 -m py_compile docs/examples/*/*/*.py
+	poetry run python3 -m py_compile docs/examples/*/*/*/*.py
+	poetry run python3 -m py_compile docs/examples/*/*/*/*/*.py
+	cfn-lint docs/examples/*/*.yml
+	cfn-lint docs/examples/*/*/*.yml
+	cfn-lint docs/examples/*/*/*/*.yml
+	cfn-lint docs/examples/*/*/*/*/*.yml