docs(parameters): improve readability on error handling get_parameter…

[heitorlessa]

Issue number: #2749

Summary

Correct get_parameters API docstrings example, and improve explanation and readability in Fetching parameters section

Changes

Please provide a summary of what's being changed

User experience

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

API docs

User-guide docs

Unrelated but obvious readability issue too now fixed

Checklist

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

• Meet tenets criteria
• I have performed a self-review of this change
• Changes have been 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.

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
4.6% Duplication

[codecov-commenter]

Codecov Report

Patch coverage: 50.00% and no project coverage change.

Comparison is base (e6e2908) 97.54% compared to head (9d35345) 97.54%.

❗ Your organization is not using the GitHub App Integration. As a result you may experience degraded service beginning May 15th. Please install the Github App Integration for your organization. Read more.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #2833   +/-   ##
========================================
  Coverage    97.54%   97.54%           
========================================
  Files          162      162           
  Lines         7469     7469           
  Branches       540      540           
========================================
  Hits          7286     7286           
  Misses         134      134           
  Partials        49       49           

Impacted Files	Coverage Δ
aws_lambda_powertools/utilities/parameters/ssm.py	97.59% <ø> (ø)
aws_lambda_powertools/utilities/batch/base.py	94.21% <50.00%> (ø)

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.