Skeletal documentation for authz and identity modules

Author: nickstenning

doc/modules/authz.rst

@@ -0,0 +1,8 @@
+``annotator.authz.acl`` module
+==============================
+
+This module configures an authorization policy which grants or denies permission
+on objects (especially annotations) based on the presence of ``permissions`` or
+``user`` properties on the objects.
+
+See :func:`annotator.authz.acl` for full API documentation.

doc/modules/identity.rst

@@ -0,0 +1,20 @@
+``annotator.identity.simple`` module
+=====================================
+
+This module configures an identity policy which considers the identity of the
+current user to be an opaque identifier. By default the identity is
+unconfigured, but can be set.
+
+Example
+-------
+
+::
+
+    app.include(annotator.identity.simple);
+    app
+    .start()
+    .then(function () {
+        app.ident.identity = 'joebloggs';
+    });
+
+See :func:`annotator.identity.simple` for full API documentation.