diff --git a/developer_manual/client_apis/WebDAV/comments.rst b/developer_manual/client_apis/WebDAV/comments.rst
new file mode 100644
index 000000000..76bae303d
--- /dev/null
+++ b/developer_manual/client_apis/WebDAV/comments.rst
@@ -0,0 +1,95 @@
+## Comments
+
+Comments have a PHP API within OCP and also via WebDAV. Basic documentation below.
+
+
+### Endpoint
+
+The Comments resource has an endpoint:
+
+```
+remote.php/comments/$OBJECTTYPE/$OBJECTID [/$COMMENTID]
+```
+
+The `ObjectID` endpoint accepts:
+* `POST` for creating a comment
+* `PROPFIND` to list comments, and also the read mark. You need to specify
+attributes in the request.
+* `PROPPATCH` to update the read mark, property name:
+{http://owncloud.org/ns}readMarker
+* `REPORT` to search comments
+
+The `CommentID` endpoint accepts:
+* `PROPPATCH` to update the comment
+* `DELETE` to delete it
+* `PROPFIND` to list all properties
+
+For a list of properties, see:
+`https://github.com/nextcloud/server/blob/master/apps/dav/lib/Comments/CommentNode.php#L108`
+
+### Examples of usage
+
+REPORT request:
+
+```
+curl -u user:pwd -i --data-binary "@report.xml" -X REPORT -H "Content-Type: text/xml" http://test.nextcloud.bla/master/remote.php/dav/comments/files/2156
+```
+
+report.xml your receive:
+
+```
+
+
+ 5
+ 0
+ 2016-01-18 22:10:30
+
+```
+
+Example Output (without headers):
+
+```
+
+
+
+
+ 3
+ 0
+ 0
+ 0
+ first
+ comment
+ users
+ master
+ files
+ 2156
+ 2016-01-18 22:01:16
+ 2016-01-20 14:01:24
+
+
+
+
+ 2
+ 0
+ 0
+ 0
+ first
+ comment
+ users
+ master
+ files
+ 2156
+ 2016-01-18 22:01:12
+ 2016-01-20 14:01:24
+
+
+
+```
+
+If you want a real life example of use, the announcement center has comments implemented.
+See the comments related files in `https://github.com/nextcloud/announcementcenter/tree/master/js`
+for frontend matters. Backendwise `OCP\Comments\ICommentsManager` is mostly close for housekeeping.
+It was introduced in https://github.com/nextcloud/announcementcenter/pull/12, but
+there are also some follow up PRs.
+
+
diff --git a/developer_manual/client_apis/WebDAV/index.rst b/developer_manual/client_apis/WebDAV/index.rst
index 873e46dcc..522b7b6d4 100644
--- a/developer_manual/client_apis/WebDAV/index.rst
+++ b/developer_manual/client_apis/WebDAV/index.rst
@@ -11,3 +11,4 @@ Webdav
trashbin
versions
chunking
+ comments
diff --git a/developer_manual/client_apis/activity-api.rst b/developer_manual/client_apis/activity-api.rst
new file mode 100644
index 000000000..7f769a2df
--- /dev/null
+++ b/developer_manual/client_apis/activity-api.rst
@@ -0,0 +1 @@
+Find the documentation in the Activities repo here: `https://github.com/nextcloud/activity/blob/master/docs/endpoint-v2.md`
diff --git a/developer_manual/client_apis/index.rst b/developer_manual/client_apis/index.rst
index 199702897..f87f3fdb0 100644
--- a/developer_manual/client_apis/index.rst
+++ b/developer_manual/client_apis/index.rst
@@ -13,4 +13,5 @@ Client APIs
RemoteWipe/index
ocs-share-api
ocs-sharee-api
+ activity-api