REST or OCS

[dartcafe]

This is more a question than a suggestion.

Under https://docs.nextcloud.com/server/latest/developer_manual/client_apis/OCS/index.html the usage of OCS Interface seems to be recommended (see section 'PREFER to expose your APIs using OCS'), but when clicking through to https://docs.nextcloud.com/server/latest/developer_manual/basics/controllers.html#ocs it says REST APIs are recommended.

Either it is confusing or there is something I don't understand.

[provokateurin]

OCS is what should be used. @christianlupus and me already noticed this some time ago, but forgot to fix it back then. OCS is not legacy and is the way every API in Nextcloud (except for other standard like e.g. WebDAV) should be implemented.

[christianlupus]

I was planning to update the docs here. So, please ping me if you want to work on it or have any suggestions...

[christianlupus]

I am working on #12264 to address this issue here.