Docs: New OpenAPI and Swagger UI support in Event Handler REST

[heitorlessa]

What were you searching in the docs?

(future) How to create an /swagger endpoint to visualize my API, and how to generate an OpenAPI Schema out of my code.

Is this related to an existing documentation section?

https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/api_gateway/

How can we improve?

Create the doc out of implementation

Got a suggestion in mind?

Split out OpenAPI into a separate subsection due to complexity for advanced customers wanting to extend all parts of it.

Acknowledgment

• I understand the final update might be different from my proposed suggestion, or refused.

[rubenfonseca]

Closed by #3386

[github-actions]

⚠️COMMENT VISIBILITY WARNING⚠️

This issue is now closed. Please be mindful that future comments 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.