Infer API details without requiring documentation objects.

[pierreh]

We have many projects with existing API definitions in serverless.yml. I want to generate openapi.json files without needing to document all these projects. In this PR API paths and parameters are inferred as well as using the function description.
It can also determine if path parameters are required.

[JaredCE]

Hey @pierreh Thanks so much for this PR. Just want to say i'm not ignoring it, just been really busy with work and life recently. I will try to look today or over the weekend and get this released or give some feedback.

[pierreh]

Hi @JaredCE thanks for the update! 👍

[JaredCE]

@pierreh So i think my only concern about this is... well it's quite a large change,, though it is one i'd like to make. The problem is I don't want people generating documentation for things they don't want to.

I'd say for me to be happy to merge:
http[Api] events need to have a documentation: true property so that people can control which endpoints they wish for documentation to be generated for. I'm not sure how happy you'll be with this ask, but i think users might want a bit more control.