API spec-ing can be so powerful when using the right tools. From a single source of truth, one can get: docs, generated SDKs (both backend/frontend) and functional tests.<p>Full disclosure: I'm the co-author of <a href="http://ramses.tech" rel="nofollow">http://ramses.tech</a> an API framework written in Python (on top of Pyramid for those interested to know) that generates a full blown API from a RAML file.