mirror of
https://github.com/mailscope/kumomta.git
synced 2026-08-20 11:28:17 +00:00
bd4e3f72c8
We currently use a rather hacky embedding of rapidoc to provide a generic browser around the jsonschema export from our API interface. It's not great for a couple of reasons: * The font sizes are tiny * The documentation rapidoc produces is not indexable, being generated by javascript when the browser loads. This also prevents making proper links to the various doc pages This commit introduces a little utility that we can use during the doc build to translate the schema into documentation files that can then be processed as normal by the build. This commit does this just for kumod at this time, but we could also add tsa daemon in the future if we expand its API surface.