[feature]: Write API documentation and Generate OpenAPI Specification

[Link2Twenty]

Is there an existing issue for this?

• I have searched the existing issues

Summary

I see there is a way to make markdown documentation for an API, it would really awesome if we could also generate OpenAPI documentation.

Why should this be worked on?

I think it's fair to say OpenAPI docs are used across the whole industry but are a bit of a pain to manage. Making hopscotch the best place to create and maintain OpenAPI docs would surely encourage greater adoption.

[juzhiyuan]

Hi @Link2Twenty, would you like to draft a detailed proposal?