Fix API link

[nitrosx]

Currently the documentation show a broken link to the API on the navigation in the left bar.

We need to remove such link and add a page where we explain that swagger interface is ultimate source of true regarding the API.
We should also make sure that we have instructions on how to spin up a local instance of scicat and access the swagger interface

[sbliven]

Can't we generate the swagger page in our CI? I'd prefer this to be hosted on github rather than requiring access to a scicat instance.

[dani-lbnl]

API link is still broken https://scicatproject.github.io/api/

[nitrosx]

A quick search online on "static swagger html pages", brought me to the following resources:

• https://stackoverflow.com/questions/26605217/generate-static-docs-with-swagger
• https://github.com/sourcey/spectacle
• https://medium.com/capital-one-tech/how-to-make-swagger-codegen-work-for-your-team-32194f7d97e4
• https://github.com/swagger-api/swagger-ui/pull/7832/files

I think we should test the solution offer in the last link

[nitrosx]

The link to the API has been temporarily removed, until we find a way to produce a static version of the swagger API to include in the documentation

[sbliven]

@nitrosx Would it be OK to point to the ESS swagger page until we get this building statically from CI?

https://scicat.ess.eu/explorer

[nitrosx]

@sbliven please go ahead.
We should discuss about having one of this for the latest commit on master and one for the latest release