UK: add doc to document api changes

docs/api.md

@@ -0,0 +1,16 @@
+API changes
+===========
+
+## /users, /profiles
+
+- list of users/profiles is public
+
+## /forms
+
+- username and form id_string are no longer part of the url format
+- use only a form id (number) to access a form
+- form publishing, to publish a form to a different account you have to pass the `owner` param, which is the username of that account.
+
+## /data, /stats, /stats/submission
+- username and form id_string are no longer part of the url format
+- use only a form id (number) and optionally dataid (number) to access a data node

onadata/apps/api/viewsets/xform_viewset.py

@@ -305,7 +305,7 @@ class XFormViewSet(AnonymousUserPublicFormsMixin, ModelViewSet):
 of the fields.
 
 <pre class="prettyprint">
-<b>PATCH</b> /api/v1/forms/<code>{formid}</code></pre>
+<b>PATCH</b> /api/v1/forms/<code>{pk}</code></pre>
 
 > Example
 >
@@ -336,7 +336,7 @@ class XFormViewSet(AnonymousUserPublicFormsMixin, ModelViewSet):
 ## Delete Form
 
 <pre class="prettyprint">
-<b>DELETE</b> /api/v1/forms/<code>{formid}</code></pre>
+<b>DELETE</b> /api/v1/forms/<code>{pk}</code></pre>
 > Example
 >
 >       curl -X DELETE https://ona.io/api/v1/forms/28058