[OCS has buggy behaviour with PUT and DELETE](https://github.com/owncloud/core/issues/3606) parameters, makes it hard, if not impossible to offer a RESTful API and is basically not integrated into anything, meaning you have to wire up everything from scratch.

Providing a RESTful api is as easy as creating a controller, setting up a route and return JSON, so basically I dont think theres a need to explicetly document and recommend it to app developers.

If you still use it in core, should I move it to the core documentation instead?