I've updated the API docs to use the openapi syntax and the RapiDoc UI.
See PR https://github.com/Podcastindex-org/docs-api/pull/43 for the changes.
A live version of how the docs can will look after the PR is accepted can be seen at https://stevencrader.github.io/docs-api/
@dave has merged the PR. The new site is accessible at the existing doc URL now.
@steven @dave I have to learn how to do this! Will be looking at your pull!
@steven @dave Not sure if it's habit, but my first impression is that I find the new API docs much harder to easily read than the old ones.
@martin @steven I felt that way too when he first showed it to me this week. But my eyes have already adapted to it mostly. I think it may be a contrast thing with the color pallet?
@dave @martin @steven yeah, that red on warm gray is not very easy on the eyes 🙈
@martin @dave There are some configuration options built in to RapiDoc.https://mrin9.github.io/RapiDoc/api.html
There may be some changes to make or styles to edit to make it easier to read.
@steven @dave looks awesome
Intended for all stake holders of podcasting who are interested in improving the eco system