News for hackers. Stuff that matters.
Re:Slate, create beautiful, responsive API documentation by ForHackernews on Tuesday August 18, 2020 @06:29AM (#24197093)
Can this be generated from an OpenAPI3 spec?
Re:Slate, create beautiful, responsive API documentation by RileyJames on Tuesday August 18, 2020 @06:57AM (#24197238)
This seems to be the most supported project to convert OpenAPIv3 + other docs specs to a Slate compatible format.

https://github.com/Mermade/widdershins

Re:Slate, create beautiful, responsive API documentation by gwittel on Tuesday August 18, 2020 @09:57AM (#24198574)
I’ve used this with the CLI wrapped version that’s linked to in the readme and it works well enough. There are shins bugs/gaps in the template where some OpenApi fields are not rendered though.

In the end I containerized the whole thing with defaults, logos, etc so we’d have standard docs with little effort.