Generate OpenAPI spec for a function

[Cali0707]

It would be useful if we somehow supported generating and serving an OpenAPI spec for the route(s) served by a function, in particular documenting what the input types are.

[Cali0707]

cc @matzew @lkingland

[priyanshuharshbodhi1]

@Cali0707 , can i work on it?

[Cali0707]

From discussions in the triage call today, the idea for this feature is:

1. Each function will server a very simple OpenAPI spec documenting the default paths in a function by default
2. There will be an option to override the default handler to allow for users to implement more details into their own OpenAPI spec
3. We will start with playing around with this in https://github.com/knative-extensions/func-go, and when we are happy with it add it elsewhere

cc @lkingland in case I missed something

[Cali0707]

@Cali0707 , can i work on it?

@priyanshuharshbodhi1 if you want to feel free to work on it!

[github-actions[bot]]

This issue is stale because it has been open for 90 days with no activity. It will automatically close after 30 more days of inactivity. Reopen the issue with /reopen. Mark the issue as fresh by adding the comment /remove-lifecycle stale.