Maintenance: review API docs & README for Idempotency

[dreamorosi]

Summary

This issue is part of a larger group: #2381

As part of this task we should:

• review that the README file for the package is relevant for customers and follow the structure described in the parent issue
• review the API docs and apply the conventions described in the parent issue
• add a testing your code section & remove MD043 disable in docs page

Why is this needed?

So that customers finding the package on npm or using the API docs have the right level of details.

Which area does this relate to?

Other

Solution

No response

Acknowledgment

• This request meets Powertools for AWS Lambda (TypeScript) Tenets
• Should this be considered in other Powertools for AWS Lambda languages? i.e. Python, Java, and .NET

Future readers

Please react with 👍 and your use case to help us understand customer demand.