Docs: improve docs and examples of sample rate feature for Logger

[saragerion]

Description of the improvement

Summary of the proposal

The current version of the docs related to sample rate might be confusing and misleading, as they don't clarify the expected behaviour enough.

How, where did you look for information

Github pages docs, sample rate section + code examples

Missing or unclear documentation

https://awslabs.github.io/aws-lambda-powertools-typescript/0.2.0-beta.15/core/logger/#sampling-logs

Improvement

Clarify the expected behaviour.

Related existing documentation

Related issues, RFCs

N/A

[github-actions]

⚠️ COMMENT VISIBILITY WARNING ⚠️

Comments on closed issues are hard for our team to see.
If you need more assistance, please either tag a team member or open a new issue that references this one.
If you wish to keep having a conversation with other community members under this issue feel free to do so.