The current README and doc/ folder is partly out of date and needs to be updated to reflect the work we did in the last two months or so.
We should also write a high-level 'what is restbase' summary, and publish it on https://www.mediawiki.org/wiki/RESTBase.