Either at compile time, or at runtime (in a plugin) we should generate a swagger spec for our rest api.

If we do it in a plugin, it could document the entire rest api of all the plugins installed. This would be nice as we might be able to embed swagger-ui to show a liveish version of the documentation. I imagine this would help front end developers.