Render html from openapi spec generated by typespec

[munishchouhan]

This PR will do the followings:

1. Move typespec to resources
2. create gradle task to install and compile typespec to generate openapi.yaml
3. create html to render openapi using rapiddoc

[pditommaso]

Not sure we should include this stuff within wave backend

[munishchouhan]

Not sure we should include this stuff within wave backend

so we want to host them separately?

[pditommaso]

Think would make more sense, either in the main docs or a mini dedicated app. Tagging @ewels

[ewels]

Yup, I'd expect to keep just the typespec in the repo and have everything else compiled and hosted separately. Where that happens I don't have a strong opinion on - either the Wave service itself? Or the docs website? (NB: Not the docs repo).

Tagging @llewellyn-sl @andrew-dawson-seqera

[ewels]

Looks like the Platform API docs are hosted at https://cloud.seqera.io/openapi/index.html

So Wave docs could live at https://wave.seqera.io/openapi/index.html for example?

[pditommaso]

That's fine. Then we need to create a mini nginx service to render the docs.

[munishchouhan]

[pditommaso]

Nice, then we need to including this container build in the same process for the wave app container.

[munishchouhan]

Nice, then we need to including this container build in the same process for the wave app container.

ok sure