chore(docs): correct markdown based on markdown lint

[michaelbrewer]

Issue #, if available:

Description of changes:

Changes:

• Correct the readme me link to feature flags correct location is https://awslabs.github.io/aws-lambda-powertools-python/latest/utilities/feature_flags/
• Fix some of the json examples in feature_flags.md
• run markdownlint against all of the *.md files

Unfortunately alot of white space changes, so in the diff Hide whitespace changes make help hide the noise

Checklist

• Meet tenets criteria
• Update tests
• Update docs
• PR title follows conventional commit semantics

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

[heitorlessa]

awesome, while you're at it, could you also include this small fix here? The closing is invalid

https://github.com/awslabs/aws-lambda-powertools-python/blob/f627b02ee3fb52859a620413bb8310c74c778046/docs/utilities/feature_flags.md#L373

[michaelbrewer]

awesome, while you're at it, could you also include this small fix here? The closing is invalid

https://github.com/awslabs/aws-lambda-powertools-python/blob/f627b02ee3fb52859a620413bb8310c74c778046/docs/utilities/feature_flags.md#L373

done. there is also general formatting issues with the json

[codecov-commenter]

Codecov Report

Merging #603 (aaf817e) into develop (f627b02) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff            @@
##           develop     #603   +/-   ##
========================================
  Coverage    99.95%   99.95%           
========================================
  Files          113      113           
  Lines         4535     4535           
  Branches       246      246           
========================================
  Hits          4533     4533           
  Partials         2        2           

---

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 f627b02...aaf817e. Read the comment docs.

[michaelbrewer]

@heitorlessa - I run through all of the markdown files through vs code - markdownlint, see what you think

[heitorlessa]

1.8K changes hahaha perhaps we split into a separate PR so we know we experimented with markdown linting?

[michaelbrewer]

1.8K changes hahaha perhaps we split into a separate PR so we know we experimented with markdown linting?

Minimal changes here: #605

[michaelbrewer]

@heitorlessa i synced up the changes. So if you want to look at the impact this. I think once you have the linting working nicely. The impact will be less for future updates.

[heitorlessa]

Does it render correctly in the docs after all changes? and if you were to copy/paste the code snippets from docs, does it still work correctly e.g. indentation?

Haven't had a chance to pull this PR and try these, so I'd trust if you say so and merge it ;)

[michaelbrewer]

@heitorlessa - it does in my random testing. But I will have to think of a faster way to validate all of them.