Propagate internal error messages (e.g. spec invalid) to the API, so the error can be seen in the UI (currently: throws it internally, and viewable in the server logs)
Add a flag for enabling/disabling this behaviour: shouldn't be visible in prod
Out of scope for 1.0.0: devs can read the logs (which, to be fair, have a decent explanation). Mentioning the logs in the documentation would be good, though.
To make debugging easier:
spec invalid
) to the API, so the error can be seen in the UI (currently: throws it internally, and viewable in the server logs)