Steven Crader: "@dave has merged the PR. The new site is accessib…" - PodcastIndex Social

Mar 07, 2021, 03:21

Steven Crader @steven@podcastindex.social

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/

Steven Crader @steven@podcastindex.social

@dave has merged the PR. The new site is accessible at the existing doc URL now.

https://podcastindex-org.github.io/docs-api/

Mar 07, 2021, 05:25 · · Web · · ·

Mar 07, 2021, 05:41

Brian of London (Dev)🖥 @brianoflondon@podcastindex.social

@steven @dave I have to learn how to do this! Will be looking at your pull!

Mar 07, 2021, 10:21

Martin Mouritzen @martin@podcastindex.social

@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.

Mar 07, 2021, 15:23

Dave Jones @dave@podcastindex.social

@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?

Mar 07, 2021, 16:55

Ville of Finland @ville@podcastindex.social

@dave @martin @steven yeah, that red on warm gray is not very easy on the eyes 🙈

Mar 07, 2021, 15:50

Steven Crader @steven@podcastindex.social

@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.

Mar 07, 2021, 12:00

Lehmancreations @Lehmancreations@podcastindex.social

@steven @dave looks awesome

Sign in to participate in the conversation