chore(docs): improve idempotency documentation

[am29d]

Description of your changes

This PR brings minor improvements of the idempotency documentation. Here is the list of all the changes to make the review a bit easier:

• add requirements to install the @aws-sdk/client-dynamodb package
• add autonumber to sequence diagrams
• remove “New to idempotency callout”
• expiration should not be broken in the table
• MakeIdempotent function wrapper: move callouts under the example to improve the reader flow
• change Types tab to types.ts to make it consistent with the code
• Choosing a payload subset for idempotency:
  • change deserialising callout to warning (it’s not a tip)
  • Don’t start with the callout, add it to text
  • Payment scenario is not a quote
  • the header example does not match the text (userid and product)
• Lambda timeouts
  • clean up call outs and merge into text

Related issues, RFCs

Issue number: closes #1654

Checklist

• My changes meet the tenets criteria
• I have performed a self-review of my own code
• I have commented my code where necessary, particularly in areas that should be flagged with a TODO, or hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my change is effective and works
• The PR title follows the conventional commit semantics

Breaking change checklist

Is it a breaking change?: NO

• I have documented the migration process
• I have added, implemented necessary warnings (if it can live side by side)

---

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.

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
0.0% Duplication

[dreamorosi]

Thank you for the work on these docs Alex, appreciate it.