docs(home): extract and fix examples

[michaelbrewer]

Issue number:

• split from issue: Docs: Move code snippets into dedicated python files add formatting and linting, fixing any outstanding errors #1064
• original pr: fix(docs): extract code snippets into dedicated python files and fix examples #1065
• replaces pr: fix(docs): fix syntax errors in the lambda layer terraform example #1068
• fixes: Docs: HomePage - terraform example has a syntax error #1067
• fixes: Docs: HomePage - Fix syntax errors in SAR CDK example #1206
• fixes: Docs: HomePage - Least-privileged IAM permissions to deploy Layer has syntax errors #1207

Summary

Extract code examples from landing page and fix errors in python, yaml

Changes

Changes:

• Extract all code examples
• Fix yaml, terraform and python
• Update line highlights to be correct
• Use latest version of powertools in the examples
• Add make file to format, lint, compile and validate examples to prevent errors from coming back
• Update SAR version to 1.26.1
• Update layer version to 1.26.1

Bug fixes in this PR:

• Fixes syntax error in the HomePage - Lambda Layer - Terraform example ( See issue Docs: HomePage - terraform example has a syntax error #1067 )
• Fix python syntax for An illegal target for a variable annotation in HomePage - SAR - CDK examples ( See issue Docs: HomePage - Fix syntax errors in SAR CDK example #1206 )
• Fix template yml indents HomePage - Example: Least-privileged IAM permissions to deploy Layer example ( See issue Docs: HomePage - Least-privileged IAM permissions to deploy Layer has syntax errors #1207 )

Terraform fix Changes:

• Fix the line number highlight for the lambda layer
• aws provider needs to be a newer version to support python3.9 runtime
• Use jsonencode instead of <<EOF to fix the formatting of the terraform snippet
• run terraform fmt

Confirmed terraform changes by:

• terraform init
• tflint
• terraform plan

User experience

Please share what the user experience looks like before and after this change

Hosted version is here: https://gyft.github.io/aws-lambda-powertools-python/latest/

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• Meet tenets criteria
• I have performed a self-review of my this change
• Changes are tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change?

RFC issue number:

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

---

View rendered docs/index.md

[codecov-commenter]

Codecov Report

Merging #1113 (41124d1) into develop (f62d07a) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff            @@
##           develop    #1113   +/-   ##
========================================
  Coverage    99.88%   99.88%           
========================================
  Files          119      119           
  Lines         5423     5423           
  Branches       618      618           
========================================
  Hits          5417     5417           
  Misses           2        2           
  Partials         4        4           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update f62d07a...41124d1. Read the comment docs.

[michaelbrewer]

@heitorlessa as per your request, i am breaking the larger PR #1065 into 16 smaller PRs. This one is the for index.md landing page examples.