You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@usergrid.apache.org by sn...@apache.org on 2015/07/30 19:18:16 UTC
[2/3] incubator-usergrid git commit: Adding REST End-point and Entity
tables in tab-delimited text files and a Groovy script that turns them into
Markdown with HTML tables.
Adding REST End-point and Entity tables in tab-delimited text files and a Groovy script that turns them into Markdown with HTML tables.
Project: http://git-wip-us.apache.org/repos/asf/incubator-usergrid/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-usergrid/commit/d2c7b377
Tree: http://git-wip-us.apache.org/repos/asf/incubator-usergrid/tree/d2c7b377
Diff: http://git-wip-us.apache.org/repos/asf/incubator-usergrid/diff/d2c7b377
Branch: refs/heads/ug2-doc-update
Commit: d2c7b377267c4945cc90834fcb665cf3c8590dc9
Parents: 080f911
Author: Dave Johnson <sn...@apache.org>
Authored: Thu Jul 30 12:14:25 2015 -0400
Committer: Dave Johnson <sn...@apache.org>
Committed: Thu Jul 30 12:14:25 2015 -0400
----------------------------------------------------------------------
docs/conf.py | 12 +-
docs/data-queries/operators-and-types.md | 212 +++++++++----------
docs/data-queries/query-parameters.md | 183 ++++++++--------
docs/data-storage/data-store-dbms.md | 53 +++--
docs/data-storage/entities.md | 3 -
docs/default-entities/activity.md | 75 +++++++
docs/default-entities/application.md | 90 ++++++++
docs/default-entities/asset.md | 50 +++++
docs/default-entities/device.md | 35 +++
docs/default-entities/event.md | 60 ++++++
docs/default-entities/folder.md | 45 ++++
docs/default-entities/group.md | 40 ++++
docs/default-entities/notification.md | 50 +++++
docs/default-entities/notifier.md | 45 ++++
docs/default-entities/receipt.md | 45 ++++
docs/default-entities/role.md | 50 +++++
docs/default-entities/sources/activity.txt | 1 +
docs/default-entities/sources/application.txt | 1 +
docs/default-entities/sources/asset.txt | 1 +
docs/default-entities/sources/csv2md.groovy | 40 ++++
docs/default-entities/sources/device.txt | 1 +
docs/default-entities/sources/event.txt | 1 +
docs/default-entities/sources/folder.txt | 1 +
docs/default-entities/sources/group.txt | 1 +
docs/default-entities/sources/notification.txt | 1 +
docs/default-entities/sources/notifier.txt | 1 +
docs/default-entities/sources/receipt.txt | 1 +
docs/default-entities/sources/role.txt | 1 +
docs/default-entities/sources/user.txt | 1 +
docs/default-entities/user.md | 40 ++++
docs/geolocation/geolocation.md | 2 +
docs/index.md | 144 -------------
docs/index.rst | 193 +++++++++++++++++
docs/installation/get-up-and-running-locally.md | 72 +++++++
.../getting-up-and-running-locally.md | 72 -------
docs/rest-endpoints/access-token.md | 40 ++++
docs/rest-endpoints/activities.md | 26 +++
docs/rest-endpoints/admin-users.md | 75 +++++++
docs/rest-endpoints/collections.md | 82 +++++++
docs/rest-endpoints/events.md | 19 ++
docs/rest-endpoints/groups.md | 54 +++++
docs/rest-endpoints/organizations.md | 109 ++++++++++
docs/rest-endpoints/roles.md | 74 +++++++
docs/rest-endpoints/sources/access-token.txt | 1 +
docs/rest-endpoints/sources/activities.txt | 1 +
docs/rest-endpoints/sources/admin-users.txt | 1 +
docs/rest-endpoints/sources/collections.txt | 1 +
docs/rest-endpoints/sources/csv2md.groovy | 40 ++++
docs/rest-endpoints/sources/events.txt | 1 +
docs/rest-endpoints/sources/groups.txt | 1 +
docs/rest-endpoints/sources/organizations.txt | 1 +
docs/rest-endpoints/sources/roles.txt | 1 +
docs/rest-endpoints/sources/users.txt | 1 +
docs/rest-endpoints/users.md | 88 ++++++++
docs/sdks/ios.md | 1 +
docs/sdks/java.md | 1 +
docs/sdks/javascript.md | 25 +--
57 files changed, 1793 insertions(+), 473 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/conf.py
----------------------------------------------------------------------
diff --git a/docs/conf.py b/docs/conf.py
index 1a385fb..db1c4fe 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -25,6 +25,9 @@
import sys, os
+# CommonMarkParser causes all sorts of problems
+#from recommonmark.parser import CommonMarkParser
+
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -47,8 +50,10 @@ extensions = [
# Add any paths that contain templates here, relative to this directory.
templates_path = ['_templates']
-# The suffix of source filenames.
-source_suffix = '.md'
+#source_parsers = {
+# '.md': CommonMarkParser,
+#}
+source_suffix = ['.md','.rst']
# The encoding of source files.
#source_encoding = 'utf-8-sig'
@@ -270,4 +275,5 @@ sys.path.insert(0, os.path.abspath('./lib'))
extensions += ["sphinxcontrib_markdown"]
markdown_title = 'Apache Usergrid Documentation'
-source_suffix = '.md'
+
+
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/data-queries/operators-and-types.md
----------------------------------------------------------------------
diff --git a/docs/data-queries/operators-and-types.md b/docs/data-queries/operators-and-types.md
index 2029ce5..c67ccd1 100644
--- a/docs/data-queries/operators-and-types.md
+++ b/docs/data-queries/operators-and-types.md
@@ -1,62 +1,61 @@
-# Supported query operators & data types
+# Query operators & data types
The following operators and data types are supported by the SQL-like query language in Usergrid.
## Operators
-.. raw:: html
- <table class="usergrid-table">
- <tr>
- <td>Operator</td>
- <td>Purpose</td>
- <td>Example</td>
- </tr>
- <tr>
- <td>'<' or 'lt'</td>
- <td>Less than</td>
- <td>select * where quantity > '1000'</td>
- </tr>
- <tr>
- <td>'<=' or 'lte'</td>
- <td>Less than or equal to</td>
- <td>Example</td>
- </tr>
- <tr>
- <td>'=' or 'eq'</td>
- <td>Equals</td>
- <td>select * where price = '20.00'</td>
- </tr>
- <tr>
- <td>'>=' or 'gte'</td>
- <td>Greater than or equal to </td>
- <td>select * where quantity >= '1000'</td>
- </tr>
- <tr>
- <td>'>' or 'gt'</td>
- <td>Greater than</td>
- <td>select * where quantity > '1000'</td>
- </tr>
- <tr>
- <td>not <some_expression></td>
- <td>Subtraction of results</td>
- <td>select * where quantity < '4000' and not quantity = '2000'</td>
- </tr>
- <tr>
- <td>and</td>
- <td>Union of results</td>
- <td>select * where quantity > '1000' and quantity < '4000'</td>
- </tr>
- <tr>
- <td>or</td>
- <td>Intersection of results</td>
- <td>select * where quantity = '1000' or quantity = '4000'</td>
- </tr>
- <tr>
- <td>contains</td>
- <td>Narrow by contained text</td>
- <td>select * where title contains 'tale'</td>
- </tr>
- </table>
+<table class="usergrid-table">
+ <tr>
+ <td>Operator</td>
+ <td>Purpose</td>
+ <td>Example</td>
+ </tr>
+ <tr>
+ <td>'<' or 'lt'</td>
+ <td>Less than</td>
+ <td>select * where quantity > '1000'</td>
+ </tr>
+ <tr>
+ <td>'<=' or 'lte'</td>
+ <td>Less than or equal to</td>
+ <td>Example</td>
+ </tr>
+ <tr>
+ <td>'=' or 'eq'</td>
+ <td>Equals</td>
+ <td>select * where price = '20.00'</td>
+ </tr>
+ <tr>
+ <td>'>=' or 'gte'</td>
+ <td>Greater than or equal to </td>
+ <td>select * where quantity >= '1000'</td>
+ </tr>
+ <tr>
+ <td>'>' or 'gt'</td>
+ <td>Greater than</td>
+ <td>select * where quantity > '1000'</td>
+ </tr>
+ <tr>
+ <td>not <some_expression></td>
+ <td>Subtraction of results</td>
+ <td>select * where quantity < '4000' and not quantity = '2000'</td>
+ </tr>
+ <tr>
+ <td>and</td>
+ <td>Union of results</td>
+ <td>select * where quantity > '1000' and quantity < '4000'</td>
+ </tr>
+ <tr>
+ <td>or</td>
+ <td>Intersection of results</td>
+ <td>select * where quantity = '1000' or quantity = '4000'</td>
+ </tr>
+ <tr>
+ <td>contains</td>
+ <td>Narrow by contained text</td>
+ <td>select * where title contains 'tale'</td>
+ </tr>
+</table>
## Data types
@@ -67,56 +66,55 @@ For example, if you create an entity with a price property with a value of 100.0
For a list of property data types for each default entities, see Default Data Entity Types.
-.. raw:: html
- <table class="usergrid-table">
- <tr>
- <td>string</td>
- <td><pre>'value', unicode '\uFFFF', octal '\0707'</pre></td>
- </tr>
- <tr>
- <td>long</td>
- <td><pre>1357412326021</pre> <br> Timestamps are typically stored as long values.</td>
- </tr>
- <tr>
- <td>float</td>
- <td><pre>10.1, -10.1, 10e10, 10e-10, 10E10, 10E-10</pre> <br>
- Your query must be specific about the value you're looking for, down to the value
- (if any) after the decimal point.</td>
- </tr>
- <tr>
- <td>boolean</td>
- <td><pre>true | false</pre></td>
- </tr>
- <tr>
- <td>UUID</td>
- <td><pre>ee912c4b-5769-11e2-924d-02e81ac5a17b</pre></td>
- </tr>
- <tr>
- <td>Array</td>
- <td><pre>["boat", "car", "bike"]</pre></td>
- </tr>
- <tr>
- <td>object</td>
- <td><p>For a JSON object like this one:</p>
- <pre>
- {
- "items": [
- {
- "name": "rocks"
- },
- {
- "name": "boats"
- }
- ]
- }
- </pre>
- <p>you can use dot notation to reach property values in the object:</p>
- <pre>
- /mycollection/thing?ql="select * where items.name = 'rocks'"
- </pre>
- <p>Objects are often used to contain entity metadata, such as the activities
- associated with a user, the users associated with a role, and so on.</p>
- <p>Please note that object properties are not indexed. This means queries
- using dot-notation will be much slower than queries on indexed entity properties.</p></td>
- </tr>
- </table>
+<table class="usergrid-table">
+ <tr>
+ <td>string</td>
+ <td><pre>'value', unicode '\uFFFF', octal '\0707'</pre></td>
+ </tr>
+ <tr>
+ <td>long</td>
+ <td><pre>1357412326021</pre> <br> Timestamps are typically stored as long values.</td>
+ </tr>
+ <tr>
+ <td>float</td>
+ <td><pre>10.1, -10.1, 10e10, 10e-10, 10E10, 10E-10</pre> <br>
+ Your query must be specific about the value you're looking for, down to the value
+ (if any) after the decimal point.</td>
+ </tr>
+ <tr>
+ <td>boolean</td>
+ <td><pre>true | false</pre></td>
+ </tr>
+ <tr>
+ <td>UUID</td>
+ <td><pre>ee912c4b-5769-11e2-924d-02e81ac5a17b</pre></td>
+ </tr>
+ <tr>
+ <td>Array</td>
+ <td><pre>["boat", "car", "bike"]</pre></td>
+ </tr>
+ <tr>
+ <td>object</td>
+ <td><p>For a JSON object like this one:</p>
+ <pre>
+ {
+ "items": [
+ {
+ "name": "rocks"
+ },
+ {
+ "name": "boats"
+ }
+ ]
+ }
+ </pre>
+ <p>you can use dot notation to reach property values in the object:</p>
+ <pre>
+ /mycollection/thing?ql="select * where items.name = 'rocks'"
+ </pre>
+ <p>Objects are often used to contain entity metadata, such as the activities
+ associated with a user, the users associated with a role, and so on.</p>
+ <p>Please note that object properties are not indexed. This means queries
+ using dot-notation will be much slower than queries on indexed entity properties.</p></td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/data-queries/query-parameters.md
----------------------------------------------------------------------
diff --git a/docs/data-queries/query-parameters.md b/docs/data-queries/query-parameters.md
index 9446412..5c4cca8 100644
--- a/docs/data-queries/query-parameters.md
+++ b/docs/data-queries/query-parameters.md
@@ -22,48 +22,46 @@ __Note__: Not all string properties of the default entities are indexed for sear
The following table lists a few examples of the kind of searches you can do in queries.
-.. raw:: html
- <table class="usergrid-table">
- <tr>
- <td>Goal</td>
- <td>Example</td>
- <td>Notes</td>
- </tr>
- <tr>
- <td>Find books whose 'title' property contains the full word "tale".</td>
- <td><pre>/books?ql=select * where title contains 'tale'</pre></td>
- <td>containslooks for the occurrence of a full word anywhere in the searched property. Note that contains will not work on the 'name' property, since it is not full-text indexed in the database.</td>
- </tr>
- <tr>
- <td>Find books whose 'title' property contains a word that starts with "ta".</td>
- <td><pre>/books?ql=select * where title contains 'ta*'</pre></td>
- <td>containswill look for partial words if you include a wildcard.</td>
- </tr>
- <tr>
- <td>Find books whose title property is exactly and only "A Tale of Two Cities".</td>
- <td><pre>/books?ql=select * where title = 'A Tale of Two Cities'</pre></td>
- <td>The = operator is looking for a match in the entire searched property value. Use a * wildcard to look for some set of the first characters only.</td>
- </tr>
- </table>
+<table class="usergrid-table">
+ <tr>
+ <td>Goal</td>
+ <td>Example</td>
+ <td>Notes</td>
+ </tr>
+ <tr>
+ <td>Find books whose 'title' property contains the full word "tale".</td>
+ <td><pre>/books?ql=select * where title contains 'tale'</pre></td>
+ <td>containslooks for the occurrence of a full word anywhere in the searched property. Note that contains will not work on the 'name' property, since it is not full-text indexed in the database.</td>
+ </tr>
+ <tr>
+ <td>Find books whose 'title' property contains a word that starts with "ta".</td>
+ <td><pre>/books?ql=select * where title contains 'ta*'</pre></td>
+ <td>containswill look for partial words if you include a wildcard.</td>
+ </tr>
+ <tr>
+ <td>Find books whose title property is exactly and only "A Tale of Two Cities".</td>
+ <td><pre>/books?ql=select * where title = 'A Tale of Two Cities'</pre></td>
+ <td>The = operator is looking for a match in the entire searched property value. Use a * wildcard to look for some set of the first characters only.</td>
+ </tr>
+</table>
### Location
If you've stored location data with your entities, you can query for the proximity of the geographical locations those entities represent. For more information on geolocation, see Geolocation.
-.. raw:: html
- <table class="usergrid-table">
- <tr>
- <td>Goal</td>
- <td>Example</td>
- <td>Notes</td>
- </tr>
- <tr>
- <td>Find stores whose locations are within the specified longitude and latitude.</td>
- <td><pre>/stores?ql=location within 500 of 40.042016, -86.900749</pre></td>
- <td>within will test for values within the value you specify. The within value is expressed as a number of meters.<br>The return results are sorted in order of nearest to furthest. If there are multiple entries at the same location, they're returned in the order they were added to the database.<br> For more on geolocation queries, see Geolocation.</td>
- </tr>
- </table>
+<table class="usergrid-table">
+ <tr>
+ <td>Goal</td>
+ <td>Example</td>
+ <td>Notes</td>
+ </tr>
+ <tr>
+ <td>Find stores whose locations are within the specified longitude and latitude.</td>
+ <td><pre>/stores?ql=location within 500 of 40.042016, -86.900749</pre></td>
+ <td>within will test for values within the value you specify. The within value is expressed as a number of meters.<br>The return results are sorted in order of nearest to furthest. If there are multiple entries at the same location, they're returned in the order they were added to the database.<br> For more on geolocation queries, see Geolocation.</td>
+ </tr>
+</table>
### Order by
@@ -73,25 +71,24 @@ You can return query results that are sorted in the order you specify. Use the o
The following table includes a few examples:
-.. raw:: html
- <table class="usergrid-table">
- <tr>
- <td>Goal</td>
- <td>Example</td>
- </tr>
- <tr>
- <td>Sort by first name in ascending order</td>
- <td>/users?ql=select * where lastname = 'Smith' order by firstname asc</td>
- </tr>
- <tr>
- <td>Sort by first name in descending order</td>
- <td>/users?ql=select * where lastname = 'Smith' order by firstname desc</td>
- </tr>
- <tr>
- <td>Sort by last name, then first name in ascending orderl</td>
- <td>/users?ql=select * where lastname contains 'Sm*' order by lastname asc, firstname asc</td>
- </tr>
- <table>
+<table class="usergrid-table">
+ <tr>
+ <td>Goal</td>
+ <td>Example</td>
+ </tr>
+ <tr>
+ <td>Sort by first name in ascending order</td>
+ <td>/users?ql=select * where lastname = 'Smith' order by firstname asc</td>
+ </tr>
+ <tr>
+ <td>Sort by first name in descending order</td>
+ <td>/users?ql=select * where lastname = 'Smith' order by firstname desc</td>
+ </tr>
+ <tr>
+ <td>Sort by last name, then first name in ascending orderl</td>
+ <td>/users?ql=select * where lastname contains 'Sm*' order by lastname asc, firstname asc</td>
+ </tr>
+<table>
### Limit
@@ -102,32 +99,31 @@ For example, you might execute a query that could potentially return hundreds of
You would use the following parameters in your query:
-.. raw:: html
- <table class="usergrid-table">
- <tr>
- <td>Parameter</td>
- <td>Type</td>
- <td>Description</td>
- </tr>
- <tr>
- <td>limit</td>
- <td>integer</td>
- <td><p>Number of results to return. The maximum number of results is 1,000.
- Specifying a limit greater than 1,000 will result in a limit of 1,000.</p>
- <p>You can also use the limit parameter on a request without a query string.
- The following example is shorthand for selecting all books and limiting by 100 at a time:</p>
- <pre>/books?limit=100</pre>
- <p>Using a limit on a DELETE can help you manage the amount of time it takes
- to delete data. For example you can delete all of the books, 1000 at a time,
- with the following:</p>
- <pre>DELETE /books?limit=1000</pre>
- <p> Keep in mind that DELETE operations can take longer to execute.
- Yet even though the DELETE query call might time out (such as with a
- very large limit), the operation will continue on the server even if
- the client stops waiting for the result.</p>
- </td>
- </tr>
- </table>
+<table class="usergrid-table">
+ <tr>
+ <td>Parameter</td>
+ <td>Type</td>
+ <td>Description</td>
+ </tr>
+ <tr>
+ <td>limit</td>
+ <td>integer</td>
+ <td><p>Number of results to return. The maximum number of results is 1,000.
+ Specifying a limit greater than 1,000 will result in a limit of 1,000.</p>
+ <p>You can also use the limit parameter on a request without a query string.
+ The following example is shorthand for selecting all books and limiting by 100 at a time:</p>
+ <pre>/books?limit=100</pre>
+ <p>Using a limit on a DELETE can help you manage the amount of time it takes
+ to delete data. For example you can delete all of the books, 1000 at a time,
+ with the following:</p>
+ <pre>DELETE /books?limit=1000</pre>
+ <p> Keep in mind that DELETE operations can take longer to execute.
+ Yet even though the DELETE query call might time out (such as with a
+ very large limit), the operation will continue on the server even if
+ the client stops waiting for the result.</p>
+ </td>
+ </tr>
+</table>
For example:
@@ -138,19 +134,18 @@ Select all users whose name starts with fred, and returns the first 50 results:
### Cursor
-.. raw:: html
- <table class="usergrid-table">
- <tr>
- <td>Parameter</td>
- <td>Type</td>
- <td>Description</td>
- </tr>
- <tr>
- <td>cursor</td>
- <td>string</td>
- <td>An encoded representation of the query position pointing to a set of results. To retrieve the next set of results, pass the cursor with your next call for most results./td>
- </tr>
- </table>
+<table class="usergrid-table">
+ <tr>
+ <td>Parameter</td>
+ <td>Type</td>
+ <td>Description</td>
+ </tr>
+ <tr>
+ <td>cursor</td>
+ <td>string</td>
+ <td>An encoded representation of the query position pointing to a set of results. To retrieve the next set of results, pass the cursor with your next call for most results./td>
+ </tr>
+</table>
Retrieve the next batch of users whose name is "fred", passing the cursor received from the last request to specify where the next set of results should begin:
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/data-storage/data-store-dbms.md
----------------------------------------------------------------------
diff --git a/docs/data-storage/data-store-dbms.md b/docs/data-storage/data-store-dbms.md
index 300a376..3e09d99 100644
--- a/docs/data-storage/data-store-dbms.md
+++ b/docs/data-storage/data-store-dbms.md
@@ -17,33 +17,32 @@ Fast writes to the data store.
If you have experience with relational databases and are unfamiliar with "NoSQL" databases, the following table might be a helpful start. It maps the high-level concepts of an RDBMS’s data model both to Cassandra’s and to the Usergrid, which is backed by Cassandra.
-.. raw:: html
- <table class="usergrid-table">
- <tr>
- <td></td>
- <td>RDBMS</td>
- <td>Cassandra</td>
- <td>Usergrid</td>
- </tr>
- <tr>
- <td>Each tuple is modeled as</td>
- <td>A row.</td>
- <td>A row.</td>
- <td>An entity. Written and retrieved as JSON, an entity contains values for all of its properties in the way a row has values for columns.</td>
- </tr>
- <tr>
- <td>Each data attribute is modeled as</td>
- <td>A column.</td>
- <td>A column. Many thousands of columns are supported.</td>
- <td>A entity property. An entity has a default set of properties, including the entity’s UUID. You can add many more to support your application.</td>
- </tr>
- <tr>
- <td>Each group of attributes is modeled as</td>
- <td>A table.</td>
- <td>A column family. Unlike rows in tables, rows in a column family can have differing numbers of columns. Because you’re not using a schema to define the model, you can update the column list for a row at any time.</td>
- <td>An entity collection. As with its underlying Cassandra column family, a collection can have entities with differing numbers of properties. In other words, just because one entity has an authorId property doesn’t mean that other entities in its collection need to.</td>
- </tr>
- </table>
+<table class="usergrid-table">
+<tr>
+ <td></td>
+ <td>RDBMS</td>
+ <td>Cassandra</td>
+ <td>Usergrid</td>
+</tr>
+<tr>
+ <td>Each tuple is modeled as</td>
+ <td>A row.</td>
+ <td>A row.</td>
+ <td>An entity. Written and retrieved as JSON, an entity contains values for all of its properties in the way a row has values for columns.</td>
+</tr>
+<tr>
+ <td>Each data attribute is modeled as</td>
+ <td>A column.</td>
+ <td>A column. Many thousands of columns are supported.</td>
+ <td>A entity property. An entity has a default set of properties, including the entity’s UUID. You can add many more to support your application.</td>
+</tr>
+<tr>
+ <td>Each group of attributes is modeled as</td>
+ <td>A table.</td>
+ <td>A column family. Unlike rows in tables, rows in a column family can have differing numbers of columns. Because you’re not using a schema to define the model, you can update the column list for a row at any time.</td>
+ <td>An entity collection. As with its underlying Cassandra column family, a collection can have entities with differing numbers of properties. In other words, just because one entity has an authorId property doesn’t mean that other entities in its collection need to.</td>
+</tr>
+</table>
The following examples from a product database provide simple illustrations of these differences.
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/data-storage/entities.md
----------------------------------------------------------------------
diff --git a/docs/data-storage/entities.md b/docs/data-storage/entities.md
index 22d8f18..8a53923 100644
--- a/docs/data-storage/entities.md
+++ b/docs/data-storage/entities.md
@@ -250,7 +250,6 @@ Response:
"applicationName" : "sandbox"
}
-
### Retrieving multiple entities
This example describes how to retrieve multiple entities by UUID. You can also retrieve a set of entities by using a query string. For more information on querying your data, see Querying your data.
@@ -451,8 +450,6 @@ Response:
"applicationName" : "your-app"
}
-.. --------------------------------------------------------------------------------
-
## Deleting Data Entities
This article describes how to delete data entities.
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/activity.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/activity.md b/docs/default-entities/activity.md
new file mode 100644
index 0000000..c6642db
--- /dev/null
+++ b/docs/default-entities/activity.md
@@ -0,0 +1,75 @@
+# activity
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity ID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>string</td>
+ <td>Type of entity, in this case 'activity'</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>actor</td>
+ <td>ActivityObject</td>
+ <td>Required. Entity that performed the 'action' of the activity (see JSON Activity Streams 1.0 specification). By default, the UUID of the user who performed the action is recorded as the value of the 'uuid' property of this object.</td>
+ </tr>
+ <tr>
+ <td>verb</td>
+ <td>string</td>
+ <td>Required. The action performed by the user (for example, post)</td>
+ </tr>
+ <tr>
+ <td>published</td>
+ <td>long</td>
+ <td>Required. UTC timestamp in milliseconds of when the activity was published</td>
+ </tr>
+ <tr>
+ <td>content</td>
+ <td>string</td>
+ <td>Optional. Description of the activity</td>
+ </tr>
+ <tr>
+ <td>icon</td>
+ <td>MediaLink</td>
+ <td>Optional. Visual representation of a media link resource (see JSON Activity Streams 1.0 specification)</td>
+ </tr>
+ <tr>
+ <td>category</td>
+ <td>string</td>
+ <td>Optional. Category used to organize activities</td>
+ </tr>
+ <tr>
+ <td>published</td>
+ <td>long</td>
+ <td>Optional. UTC timestamp in milliseconds when the activity was published</td>
+ </tr>
+ <tr>
+ <td>object</td>
+ <td>ActivityObject</td>
+ <td>Optional. Object on which the action is performed (see JSON Activity Streams 1.0 specification)</td>
+ </tr>
+ <tr>
+ <td>title</td>
+ <td>string</td>
+ <td>Optional. Title or headline for the activity</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides the relative path to the activity entity, as well as additional data entities associated with the activity. The following properties are included in metadata: path: Path to retrieve the activity entity, including the UUID of the user entity associated with the activity and the UUID of the activity entity</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/application.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/application.md b/docs/default-entities/application.md
new file mode 100644
index 0000000..72774a4
--- /dev/null
+++ b/docs/default-entities/application.md
@@ -0,0 +1,90 @@
+# application
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity ID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>String</td>
+ <td>Type of entity, in this case 'application'</td>
+ </tr>
+ <tr>
+ <td>name</td>
+ <td>string</td>
+ <td>Optional. Application name</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>accesstokenttl</td>
+ <td>long</td>
+ <td>Optional. Time to live value for an access token obtained within the application</td>
+ </tr>
+ <tr>
+ <td>organizationName</td>
+ <td>string</td>
+ <td>Name of the organization the application belongs to</td>
+ </tr>
+ <tr>
+ <td>applicationName</td>
+ <td>string</td>
+ <td>Name of the application</td>
+ </tr>
+ <tr>
+ <td>title</td>
+ <td>string</td>
+ <td>Optional. Application title</td>
+ </tr>
+ <tr>
+ <td>description</td>
+ <td>string</td>
+ <td>Optional. Application description</td>
+ </tr>
+ <tr>
+ <td>activated</td>
+ <td>boolean</td>
+ <td>Optional. Whether application is activated</td>
+ </tr>
+ <tr>
+ <td>disabled</td>
+ <td>boolean</td>
+ <td>Optional. Whether application is administratively disabled</td>
+ </tr>
+ <tr>
+ <td>allowOpenRegistration</td>
+ <td>boolean</td>
+ <td>Optional. Whether application allows any user to register</td>
+ </tr>
+ <tr>
+ <td>registrationRequiresEmailConfirmation</td>
+ <td>boolean</td>
+ <td>Optional. Whether registration requires email confirmation</td>
+ </tr>
+ <tr>
+ <td>registrationRequiresAdminApproval</td>
+ <td>boolean</td>
+ <td>Optional. Whether registration requires admin approval</td>
+ </tr>
+ <tr>
+ <td>notify_admin_of_new_users</td>
+ <td>boolean</td>
+ <td>Optional. Whether application admins should be notified of new users</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides a 'collections' object with the relative paths to all entity collections associated with the application. The following collections are included in metadata by default: users: Path to retrieve the /users collection groups: Path to retrieve the /groups collection folders: Path to retrieve the /folders collection events: Path to retrieve the /events collection assets: Path to retrieve the /assets collection activities: Path to retrieve the /activities collection devices: Path to retrieve the /devices collection notifiers: Path to retrieve the /notifiers collection notifications: Path to retrieve the /notifications collection receipts: Path to retrieve the /receipts collection</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/asset.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/asset.md b/docs/default-entities/asset.md
new file mode 100644
index 0000000..a5f1b20
--- /dev/null
+++ b/docs/default-entities/asset.md
@@ -0,0 +1,50 @@
+# asset
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity ID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>string</td>
+ <td>Type of entity, in this case 'asset'</td>
+ </tr>
+ <tr>
+ <td>name</td>
+ <td>string</td>
+ <td>Optional. Asset name</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>owner</td>
+ <td>UUID</td>
+ <td>Required. UUID of the user entity that owns the asset</td>
+ </tr>
+ <tr>
+ <td>path</td>
+ <td>string</td>
+ <td>Required. Relative path to the asset</td>
+ </tr>
+ <tr>
+ <td>content-type</td>
+ <td>string</td>
+ <td>MIME media type that describes the asset (see media types)</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides the relative path to the asset entity, as well as additional data entities associated with the asset. The following properties are included in metadata: path: Path to retrieve the asset entity</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/device.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/device.md b/docs/default-entities/device.md
new file mode 100644
index 0000000..ec6ac8c
--- /dev/null
+++ b/docs/default-entities/device.md
@@ -0,0 +1,35 @@
+# device
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity ID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>string</td>
+ <td>Type of entity, in this case 'device'</td>
+ </tr>
+ <tr>
+ <td>name</td>
+ <td>string</td>
+ <td>Optional. Device name</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides the relative path to the device entity, as well as additional data entities associated with the user. The following properties are included in metadata: path: Path to retrieve the device entity, including the device UUID collections: Nested object that contains paths to data entity collections associated with the device. receipts: Receipt entities associated with the device users: User entities associated with the device</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/event.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/event.md b/docs/default-entities/event.md
new file mode 100644
index 0000000..bcbc3fc
--- /dev/null
+++ b/docs/default-entities/event.md
@@ -0,0 +1,60 @@
+# event
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity ID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>String</td>
+ <td>Type of entity, in this case 'event'</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>timestamp</td>
+ <td>long</td>
+ <td>Required. UTC timestamp in milliseconds of when the application event occurred</td>
+ </tr>
+ <tr>
+ <td>user</td>
+ <td>UUID</td>
+ <td>Optional. UUID of application user that posted the event</td>
+ </tr>
+ <tr>
+ <td>group</td>
+ <td>UUID</td>
+ <td>Optional. UUID of application group that posted the event</td>
+ </tr>
+ <tr>
+ <td>category</td>
+ <td>string</td>
+ <td>Optional. Category used for organizing similar events</td>
+ </tr>
+ <tr>
+ <td>counters</td>
+ <td>map</td>
+ <td>Optional. Counter used for tracking number of similar events</td>
+ </tr>
+ <tr>
+ <td>message</td>
+ <td>string</td>
+ <td>Optional. Message describing event. Will be null if no message is specified</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides the relative path to the event entity, as well as additional data entities associated with the event. The following properties are included in metadata: path: Path to retrieve the event entity</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/folder.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/folder.md b/docs/default-entities/folder.md
new file mode 100644
index 0000000..04a08ed
--- /dev/null
+++ b/docs/default-entities/folder.md
@@ -0,0 +1,45 @@
+# folder
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity ID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>string</td>
+ <td>Type of entity, in this case 'folder'</td>
+ </tr>
+ <tr>
+ <td>name</td>
+ <td>string</td>
+ <td>Optional. Folder name</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>owner</td>
+ <td>UUID</td>
+ <td>Required. UUID of the folder's owner</td>
+ </tr>
+ <tr>
+ <td>path</td>
+ <td>string</td>
+ <td>Required. Relative path to the folder</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides the relative path to the folder entity, as well as additional data entities associated with the asset. The following properties are included in metadata: path: Path to retrieve the folder entity</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/group.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/group.md b/docs/default-entities/group.md
new file mode 100644
index 0000000..dbe59b8
--- /dev/null
+++ b/docs/default-entities/group.md
@@ -0,0 +1,40 @@
+# group
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity UUID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>string</td>
+ <td>Type of entity, in this case 'group'</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>path</td>
+ <td>string</td>
+ <td>Required. Relative path where the group can be retrieved</td>
+ </tr>
+ <tr>
+ <td>title</td>
+ <td>string</td>
+ <td>Optional. Display name for the group entity</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides the relative path to the group entity, as well as additional data entities associated with the group. The following properties are included in metadata: path: Path to retrieve the group entity, including the group UUID sets: Nested object that contains the 'rolenames' and 'permissions' properties. rolenames: Path to retrieve a list of roles associated with the group. permissions: Path to retrieve a list of all permissions directly associated with the group. If the group is associated with a role, the list will not include permissions associated with the role entity. collections: Nested object that contains paths to data entity collections associated with the group. activities: Activity entities associated with the group feed: A feed of all activities published by users associated with the group roles: Role entities associated with the group users: User entities associated with the group</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/notification.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/notification.md b/docs/default-entities/notification.md
new file mode 100644
index 0000000..4332ad7
--- /dev/null
+++ b/docs/default-entities/notification.md
@@ -0,0 +1,50 @@
+# notification
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity ID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>string</td>
+ <td>Type of entity, in this case 'notification'</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>payloads</td>
+ <td>string</td>
+ <td>Required. The push notifications to be delivered, formatted as key-value pairs of notifier entities and messages (<notifier_name1>:<message1>, <notifier_name2>:<message2>, ...)</td>
+ </tr>
+ <tr>
+ <td>errorMessage</td>
+ <td>string</td>
+ <td>Error message returned by the notification service (APNs or GCM) if the notification fails entirely</td>
+ </tr>
+ <tr>
+ <td>scheduled</td>
+ <td>bool</td>
+ <td>Whether the notification is currently scheduled for delivery</td>
+ </tr>
+ <tr>
+ <td>state</td>
+ <td>string</td>
+ <td>The current delivery status of the notification: FINISHED, SCHEDULED or CANCELED.</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides the relative path to the notification entity, as well as additional data entities associated with the notification. The following properties are included in metadata: path: Path to retrieve the notification object collections: Nested object that contains paths to data entity collections associated with the notification. queue: Device entities scheduled to receive the push notification receipts: Receipt entities for delivery attempts</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/notifier.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/notifier.md b/docs/default-entities/notifier.md
new file mode 100644
index 0000000..bb3a932
--- /dev/null
+++ b/docs/default-entities/notifier.md
@@ -0,0 +1,45 @@
+# notifier
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity ID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>string</td>
+ <td>Type of entity, in this case 'notifier'</td>
+ </tr>
+ <tr>
+ <td>name</td>
+ <td>string</td>
+ <td>Optional. Notifier display name</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>provider</td>
+ <td>string</td>
+ <td>Required. Push notification provider: apple or google</td>
+ </tr>
+ <tr>
+ <td>environment</td>
+ <td>string</td>
+ <td>Required. The environment that corresponds to your app: development or production</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides the relative path to the notifier entity path: Path to retrieve the notification object</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/receipt.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/receipt.md b/docs/default-entities/receipt.md
new file mode 100644
index 0000000..342af77
--- /dev/null
+++ b/docs/default-entities/receipt.md
@@ -0,0 +1,45 @@
+# receipt
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity ID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>string</td>
+ <td>Type of entity, in this case 'notifier'</td>
+ </tr>
+ <tr>
+ <td>name</td>
+ <td>string</td>
+ <td>Optional. Notifier display name</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>provider</td>
+ <td>string</td>
+ <td>Required. Push notification provider: apple or google</td>
+ </tr>
+ <tr>
+ <td>environment</td>
+ <td>string</td>
+ <td>Required. The environment that corresponds to your app: development or production</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides the relative path to the notifier entity path: Path to retrieve the notification object</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/role.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/role.md b/docs/default-entities/role.md
new file mode 100644
index 0000000..b2529ff
--- /dev/null
+++ b/docs/default-entities/role.md
@@ -0,0 +1,50 @@
+# role
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity ID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>string</td>
+ <td>Type of entity, in this case 'role'</td>
+ </tr>
+ <tr>
+ <td>name</td>
+ <td>string</td>
+ <td>Optional. Unique name that identifies the role</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>roleName</td>
+ <td>string</td>
+ <td>Identical to the value of the 'name' property by default</td>
+ </tr>
+ <tr>
+ <td>title</td>
+ <td>string</td>
+ <td>Identical to the value of the 'name' property by default</td>
+ </tr>
+ <tr>
+ <td>inactivity</td>
+ <td>string</td>
+ <td>The amount of time, in milliseconds, that a user or group associated with the role can be inactive before they lose the permissions associated with that role. By default, 'inactivity' is set to 0 so that the user/group never loses the role.</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides the relative path to the role entity, as well as additional data entities associated with the role. The following properties are included in metadata: path: Path to retrieve the role entity sets: Nested object that contains the 'permissions' property. permissions: Path to retrieve a list of all permissions associated with the role. collections: Nested object that contains paths to data entity collections associated with the role. groups: Group entities associated with the role users: User entities associated with the role</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/activity.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/activity.txt b/docs/default-entities/sources/activity.txt
new file mode 100644
index 0000000..a8237f2
--- /dev/null
+++ b/docs/default-entities/sources/activity.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity ID
type string Type of entity, in this case 'activity'
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
actor ActivityObject Required. Entity that performed the 'action' of the activity (see JSON Activity Streams 1.0 specification). By default, the UUID of the user who performed the action is recorded as the value of the 'uuid' property of this object.
verb string Required. The action performed by the user (for example, post)
published long Required. UTC timestamp in milliseconds of when the activity was published
content string Optional. Description of the activity
icon MediaLink Optional. Visual representation of a media link resource (see JSON Activity Streams 1.0 specification)
category string Optional. Category used to organize activities
published long Optional. UTC timestamp in milliseconds when the activity was published
object ActivityObject Opti
onal. Object on which the action is performed (see JSON Activity Streams 1.0 specification)
title string Optional. Title or headline for the activity
metadata object A nested, JSON-formatted object that provides the relative path to the activity entity, as well as additional data entities associated with the activity. The following properties are included in metadata: path: Path to retrieve the activity entity, including the UUID of the user entity associated with the activity and the UUID of the activity entity
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/application.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/application.txt b/docs/default-entities/sources/application.txt
new file mode 100644
index 0000000..fde95f1
--- /dev/null
+++ b/docs/default-entities/sources/application.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity ID
type String Type of entity, in this case 'application'
name string Optional. Application name
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
accesstokenttl long Optional. Time to live value for an access token obtained within the application
organizationName string Name of the organization the application belongs to
applicationName string Name of the application
title string Optional. Application title
description string Optional. Application description
activated boolean Optional. Whether application is activated
disabled boolean Optional. Whether application is administratively disabled
allowOpenRegistration boolean Optional. Whether application allows any user to register
registrationRequiresEmailConfirmation boolean Optional. Whether registration requires email confirmation
registrationRequiresAdminApproval boolean Optional. Whether registration
requires admin approval
notify_admin_of_new_users boolean Optional. Whether application admins should be notified of new users
metadata object A nested, JSON-formatted object that provides a 'collections' object with the relative paths to all entity collections associated with the application. The following collections are included in metadata by default: users: Path to retrieve the /users collection groups: Path to retrieve the /groups collection folders: Path to retrieve the /folders collection events: Path to retrieve the /events collection assets: Path to retrieve the /assets collection activities: Path to retrieve the /activities collection devices: Path to retrieve the /devices collection notifiers: Path to retrieve the /notifiers collection notifications: Path to retrieve the /notifications collection receipts: Path to retrieve the /receipts collection
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/asset.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/asset.txt b/docs/default-entities/sources/asset.txt
new file mode 100644
index 0000000..463fe44
--- /dev/null
+++ b/docs/default-entities/sources/asset.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity ID
type string Type of entity, in this case 'asset'
name string Optional. Asset name
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
owner UUID Required. UUID of the user entity that owns the asset
path string Required. Relative path to the asset
content-type string MIME media type that describes the asset (see media types)
metadata object A nested, JSON-formatted object that provides the relative path to the asset entity, as well as additional data entities associated with the asset. The following properties are included in metadata: path: Path to retrieve the asset entity
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/csv2md.groovy
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/csv2md.groovy b/docs/default-entities/sources/csv2md.groovy
new file mode 100644
index 0000000..9113c35
--- /dev/null
+++ b/docs/default-entities/sources/csv2md.groovy
@@ -0,0 +1,40 @@
+def dir = new File(".");
+def files = dir.list();
+files.each() { fileName ->
+ if ( fileName.endsWith(".txt") ) {
+
+ def baseName = fileName.substring(0, fileName.length() - 4);
+
+ def outputFile = new File("../" + baseName + ".md");
+ outputFile.withWriter('utf-8') { writer ->
+
+ def inputFile = new File(fileName);
+ def count = 0;
+ writer.writeLine "# ${baseName}"
+ writer.writeLine ""
+ writer.writeLine "<!-- DO NOT EDIT THIS GENERATED FILE -->";
+ writer.writeLine "<table class='usergrid-table rest-endpoints-table'>";
+
+ inputFile.eachLine { line ->
+ def parts = line.split("\\t")
+ if ( count == 0 ) {
+ writer.writeLine " <tr>";
+ parts.each() { part ->
+ writer.writeLine " <th>" + part + "</th>";
+ }
+ writer.writeLine " </tr>";
+ } else {
+ writer.writeLine " <tr>";
+ parts.each() { part ->
+ writer.writeLine " <td>" + part + "</td>";
+ }
+ writer.writeLine " </tr>";
+ }
+ count++;
+ }
+ writer.writeLine "</table>";
+
+ }
+ }
+}
+
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/device.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/device.txt b/docs/default-entities/sources/device.txt
new file mode 100644
index 0000000..a65adec
--- /dev/null
+++ b/docs/default-entities/sources/device.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity ID
type string Type of entity, in this case 'device'
name string Optional. Device name
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
metadata object A nested, JSON-formatted object that provides the relative path to the device entity, as well as additional data entities associated with the user. The following properties are included in metadata: path: Path to retrieve the device entity, including the device UUID collections: Nested object that contains paths to data entity collections associated with the device. receipts: Receipt entities associated with the device users: User entities associated with the device
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/event.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/event.txt b/docs/default-entities/sources/event.txt
new file mode 100644
index 0000000..c4dbcb3
--- /dev/null
+++ b/docs/default-entities/sources/event.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity ID
type String Type of entity, in this case 'event'
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
timestamp long Required. UTC timestamp in milliseconds of when the application event occurred
user UUID Optional. UUID of application user that posted the event
group UUID Optional. UUID of application group that posted the event
category string Optional. Category used for organizing similar events
counters map Optional. Counter used for tracking number of similar events
message string Optional. Message describing event. Will be null if no message is specified
metadata object A nested, JSON-formatted object that provides the relative path to the event entity, as well as additional data entities associated with the event. The following properties are included in metadata: path: Path to retrieve the event entity
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/folder.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/folder.txt b/docs/default-entities/sources/folder.txt
new file mode 100644
index 0000000..bf65c85
--- /dev/null
+++ b/docs/default-entities/sources/folder.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity ID
type string Type of entity, in this case 'folder'
name string Optional. Folder name
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
owner UUID Required. UUID of the folder's owner
path string Required. Relative path to the folder
metadata object A nested, JSON-formatted object that provides the relative path to the folder entity, as well as additional data entities associated with the asset. The following properties are included in metadata: path: Path to retrieve the folder entity
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/group.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/group.txt b/docs/default-entities/sources/group.txt
new file mode 100644
index 0000000..d31a8e8
--- /dev/null
+++ b/docs/default-entities/sources/group.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity UUID
type string Type of entity, in this case 'group'
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
path string Required. Relative path where the group can be retrieved
title string Optional. Display name for the group entity
metadata object A nested, JSON-formatted object that provides the relative path to the group entity, as well as additional data entities associated with the group. The following properties are included in metadata: path: Path to retrieve the group entity, including the group UUID sets: Nested object that contains the 'rolenames' and 'permissions' properties. rolenames: Path to retrieve a list of roles associated with the group. permissions: Path to retrieve a list of all permissions directly associated with the group. If the group is associated with a role, the list will not include permissions associated with the role entity. col
lections: Nested object that contains paths to data entity collections associated with the group. activities: Activity entities associated with the group feed: A feed of all activities published by users associated with the group roles: Role entities associated with the group users: User entities associated with the group
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/notification.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/notification.txt b/docs/default-entities/sources/notification.txt
new file mode 100644
index 0000000..df1e4bf
--- /dev/null
+++ b/docs/default-entities/sources/notification.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity ID
type string Type of entity, in this case 'notification'
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
payloads string Required. The push notifications to be delivered, formatted as key-value pairs of notifier entities and messages (<notifier_name1>:<message1>, <notifier_name2>:<message2>, ...)
errorMessage string Error message returned by the notification service (APNs or GCM) if the notification fails entirely
scheduled bool Whether the notification is currently scheduled for delivery
state string The current delivery status of the notification: FINISHED, SCHEDULED or CANCELED.
metadata object A nested, JSON-formatted object that provides the relative path to the notification entity, as well as additional data entities associated with the notification. The following properties are included in metadata: path: Path to retrieve the notification object
collections: Nested object that contains paths to data entity collections associated with the notification. queue: Device entities scheduled to receive the push notification receipts: Receipt entities for delivery attempts
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/notifier.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/notifier.txt b/docs/default-entities/sources/notifier.txt
new file mode 100644
index 0000000..238ff62
--- /dev/null
+++ b/docs/default-entities/sources/notifier.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity ID
type string Type of entity, in this case 'notifier'
name string Optional. Notifier display name
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
provider string Required. Push notification provider: apple or google
environment string Required. The environment that corresponds to your app: development or production
metadata object A nested, JSON-formatted object that provides the relative path to the notifier entity path: Path to retrieve the notification object
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/receipt.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/receipt.txt b/docs/default-entities/sources/receipt.txt
new file mode 100644
index 0000000..238ff62
--- /dev/null
+++ b/docs/default-entities/sources/receipt.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity ID
type string Type of entity, in this case 'notifier'
name string Optional. Notifier display name
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
provider string Required. Push notification provider: apple or google
environment string Required. The environment that corresponds to your app: development or production
metadata object A nested, JSON-formatted object that provides the relative path to the notifier entity path: Path to retrieve the notification object
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/role.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/role.txt b/docs/default-entities/sources/role.txt
new file mode 100644
index 0000000..20d303f
--- /dev/null
+++ b/docs/default-entities/sources/role.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity ID
type string Type of entity, in this case 'role'
name string Optional. Unique name that identifies the role
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
roleName string Identical to the value of the 'name' property by default
title string Identical to the value of the 'name' property by default
inactivity string The amount of time, in milliseconds, that a user or group associated with the role can be inactive before they lose the permissions associated with that role. By default, 'inactivity' is set to 0 so that the user/group never loses the role.
metadata object A nested, JSON-formatted object that provides the relative path to the role entity, as well as additional data entities associated with the role. The following properties are included in metadata: path: Path to retrieve the role entity sets: Nested object that contains the 'permissions' pr
operty. permissions: Path to retrieve a list of all permissions associated with the role. collections: Nested object that contains paths to data entity collections associated with the role. groups: Group entities associated with the role users: User entities associated with the role
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/sources/user.txt
----------------------------------------------------------------------
diff --git a/docs/default-entities/sources/user.txt b/docs/default-entities/sources/user.txt
new file mode 100644
index 0000000..31c3e0d
--- /dev/null
+++ b/docs/default-entities/sources/user.txt
@@ -0,0 +1 @@
+uuid UUID Unique entity ID
type string Type of entity, in this case 'user'
created long UTC timestamp in milliseconds of when the entity was created
modified long UTC timestamp in milliseconds of when the entity was last modified
username string Required. Valid and unique username
activated boolean Whether the user account is activated. Set to 'true' by default when the user is created.
metadata object A nested, JSON-formatted object that provides the relative path to the user entity, as well as additional data entities associated with the user. The following properties are included in metadata: path: Path to retrieve the user entity sets: Nested object that contains the 'rolenames' and 'permissions' properties. rolenames: Deprecated. Use /users/\/roles|username\> instead. Path to retrieve a list of roles associated with the user. permissions: Path to retrieve a list of all permissions directly associated with the user. If the user is associated with a role or group, the list will n
ot include permissions associated with those entities. collections: Nested object that contains paths to data entity collections associated with the user. activities: Activity entities associated with the user devices: Device entities associated with the user feed: A feed of all activities published by the user groups: Group entities associated with the user roles: Role entities associated with the user following: Users that the user is following followers: Users that are following the user
\ No newline at end of file
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/default-entities/user.md
----------------------------------------------------------------------
diff --git a/docs/default-entities/user.md b/docs/default-entities/user.md
new file mode 100644
index 0000000..627c559
--- /dev/null
+++ b/docs/default-entities/user.md
@@ -0,0 +1,40 @@
+# user
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>uuid</th>
+ <th>UUID</th>
+ <th>Unique entity ID</th>
+ </tr>
+ <tr>
+ <td>type</td>
+ <td>string</td>
+ <td>Type of entity, in this case 'user'</td>
+ </tr>
+ <tr>
+ <td>created</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was created</td>
+ </tr>
+ <tr>
+ <td>modified</td>
+ <td>long</td>
+ <td>UTC timestamp in milliseconds of when the entity was last modified</td>
+ </tr>
+ <tr>
+ <td>username</td>
+ <td>string</td>
+ <td>Required. Valid and unique username</td>
+ </tr>
+ <tr>
+ <td>activated</td>
+ <td>boolean</td>
+ <td>Whether the user account is activated. Set to 'true' by default when the user is created.</td>
+ </tr>
+ <tr>
+ <td>metadata</td>
+ <td>object</td>
+ <td>A nested, JSON-formatted object that provides the relative path to the user entity, as well as additional data entities associated with the user. The following properties are included in metadata: path: Path to retrieve the user entity sets: Nested object that contains the 'rolenames' and 'permissions' properties. rolenames: Deprecated. Use /users/\/roles|username\> instead. Path to retrieve a list of roles associated with the user. permissions: Path to retrieve a list of all permissions directly associated with the user. If the user is associated with a role or group, the list will not include permissions associated with those entities. collections: Nested object that contains paths to data entity collections associated with the user. activities: Activity entities associated with the user devices: Device entities associated with the user feed: A feed of all activities published by the user groups: Group entities associated with the user roles: Role entities associated with
the user following: Users that the user is following followers: Users that are following the user</td>
+ </tr>
+</table>
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/geolocation/geolocation.md
----------------------------------------------------------------------
diff --git a/docs/geolocation/geolocation.md b/docs/geolocation/geolocation.md
new file mode 100644
index 0000000..f22475c
--- /dev/null
+++ b/docs/geolocation/geolocation.md
@@ -0,0 +1,2 @@
+# Geolocation
+
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/index.md
----------------------------------------------------------------------
diff --git a/docs/index.md b/docs/index.md
deleted file mode 100644
index 0078c53..0000000
--- a/docs/index.md
+++ /dev/null
@@ -1,144 +0,0 @@
-*****************************
-Apache Usergrid Documentation
-*****************************
-
-.. _intro::
-
-.. toctree::
- :maxdepth: 2
- :caption: Introduction
-
- introduction/usergrid-features
- introduction/data-model
- introduction/async-vs-sync
-
-.. _getting-started:
-
-.. toctree::
- :maxdepth: 2
- :caption: Getting Started
-
- getting-started/creating-a-new-application
- getting-started/creating-account
- getting-started/using-a-sandbox-app
- getting-started/using-the-api.md
-
-.. _data-storage:
-
-.. toctree::
- :maxdepth: 2
- :caption: Data Storage
-
- data-storage/data-store-dbms
- data-storage/optimizing-access
- data-storage/collections
- data-storage/entities
-
-.. _data-queries:
-
-.. toctree::
- :maxdepth: 2
- :caption: Data Queries
-
- data-queries/querying-your-data
- data-queries/query-parameters
- data-queries/operators-and-types
- data-queries/advanced-query-usage
-
-.. _entity-connections:
-
-.. toctree::
- :maxdepth: 2
- :caption: Entity Connections
-
- entity-connections/connecting-entities
- entity-connections/retrieving-entities
- entity-connections/disconnecting-entities
-
-.. _push-notifications:
-
-.. toctree::
- :maxdepth: 2
- :caption: Push Notifications
-
- push-notifications/users-devices
-
-.. _security-and-authentication:
-
-.. toctree::
- :maxdepth: 2
- :caption: Security and Authentication
-
- security-and-auth/roles-and-permissions
-
-.. _user-management-and-social-graph:
-
-.. toctree::
- :maxdepth: 2
- :caption: User Management and Social Graph
-
- user-management/activity
- user-management/groups
-
-.. _geolocation:
-
-.. toctree::
- :maxdepth: 2
- :caption: Geolocation
-
- geolocation
-
-.. _asset-and-file-management:
-
-.. toctree::
- :maxdepth: 2
- :caption: Assets and Files
-
- asset-and-files/assets
- asset-and-files/file-storage-configuration
-
-.. _counters-and-events:
-
-.. toctree::
- :maxdepth: 2
- :caption: Counters and Events
-
- counters-and-events/events-and-counters
-
-.. _organization-and-application-management:
-
-.. toctree::
- :maxdepth: 2
- :caption: Organizations and Applications
-
- orgs-and-apps/applications
- orgs-and-apps/organizations-admins
-
-.. _sdks:
-
-.. toctree::
- :maxdepth: 2
- :caption: Software Development Kits (SDKs)
-
- sdks/ios
- sdks/java
- sdks/javascript
- sdks/usage
-
-.. _references:
-
-.. toctree::
- :maxdepth: 2
- :caption: Reference and other docs
-
- reference/presentations
- reference/videos
-
-.. _installation:
-
-.. toctree::
- :maxdepth: 2
- :caption: Installing the Usergrid stack
-
- installation
-
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/index.rst
----------------------------------------------------------------------
diff --git a/docs/index.rst b/docs/index.rst
new file mode 100644
index 0000000..46460d5
--- /dev/null
+++ b/docs/index.rst
@@ -0,0 +1,193 @@
+*****************************
+Apache Usergrid Documentation
+*****************************
+
+.. _intro::
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Introduction
+
+ introduction/usergrid-features
+ introduction/data-model
+ introduction/async-vs-sync
+
+.. _getting-started:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Getting Started
+
+ getting-started/creating-a-new-application
+ getting-started/creating-account
+ getting-started/using-a-sandbox-app
+ getting-started/using-the-api.md
+
+.. _data-storage:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Data Storage
+
+ data-storage/data-store-dbms
+ data-storage/optimizing-access
+ data-storage/collections
+ data-storage/entities
+
+.. _data-queries:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Data Queries
+
+ data-queries/querying-your-data
+ data-queries/query-parameters
+ data-queries/operators-and-types
+ data-queries/advanced-query-usage
+
+.. _entity-connections:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Entity Connections
+
+ entity-connections/connecting-entities
+ entity-connections/retrieving-entities
+ entity-connections/disconnecting-entities
+
+.. _push-notifications:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Push Notifications
+
+ push-notifications/users-devices
+
+.. _security-and-authentication:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Security and Authentication
+
+ security-and-auth/roles-and-permissions
+
+.. _user-management-and-social-graph:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: User Management and Social Graph
+
+ user-management/activity
+ user-management/groups
+
+.. _geolocation:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Geo-location
+
+ geolocation/geolocation
+
+.. _asset-and-file-management:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Assets and Files
+
+ asset-and-files/assets
+ asset-and-files/file-storage-configuration
+
+.. _counters-and-events:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Counters and Events
+
+ counters-and-events/events-and-counters
+
+.. _organization-and-application-management:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Organizations and Applications
+
+ orgs-and-apps/applications
+ orgs-and-apps/organizations-admins
+
+.. _sdks:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Software Development Kits (SDKs)
+
+ sdks/ios
+ sdks/java
+ sdks/javascript
+ sdks/usage
+
+.. _rest-endpoints:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: REST End-Points
+
+ rest-endpoints/access-token
+ rest-endpoints/activities
+ rest-endpoints/admin-users
+ rest-endpoints/collections
+ rest-endpoints/events
+ rest-endpoints/groups
+ rest-endpoints/organization
+ rest-endpoints/roles
+ rest-endpoints/users
+
+.. _default-entities:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Default Entities
+
+ default-entities/activity
+ default-entities/asset
+ default-entities/event
+ default-entities/group
+ default-entities/notifier
+ default-entities/role
+ default-entities/user
+ default-entities/application
+ default-entities/device
+ default-entities/folder
+ default-entities/notification
+ default-entities/receipt
+
+.. _references:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Reference and other docs
+
+ reference/presentations
+ reference/videos
+
+.. _installation:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Installing the Usergrid stack
+
+ installation/deploy-local
+ installation/get-2.0-running-locally
+ installation/get-up-and-running-locally
+ installation/upgrading
+
+.. _other:
+
+.. toctree::
+ :maxdepth: 2
+ :caption: Other (obsolete?)
+
+ entity-connections/relationships
+ data-queries/query-language
+ contribute-code
+ sdks/usage
+
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/installation/get-up-and-running-locally.md
----------------------------------------------------------------------
diff --git a/docs/installation/get-up-and-running-locally.md b/docs/installation/get-up-and-running-locally.md
new file mode 100644
index 0000000..ba7ffcc
--- /dev/null
+++ b/docs/installation/get-up-and-running-locally.md
@@ -0,0 +1,72 @@
+# Getting Up & Running Locally
+
+## Requirements
+
+* [JDK 1.7](http://www.oracle.com/technetwork/java/javase/downloads/index.html)
+* [Maven](http://maven.apache.org/)
+
+## Download
+
+### Download2
+
+Start by [downloading our latest code](https://github.com/apache/incubator-usergrid/archive/master.zip) and extract it.
+
+#### Building 3
+
+From the command line, navigate to stack directory and type the following:
+
+ mvn clean install -DskipTests=true
+
+## Running
+
+Usergrid-core contains the persistence layer and shared utilities for powering the Usergrid service. The services layer is contained in usergrid-services and exposes a higher-level API that's used by the usergrid-rest web services tier.
+
+You can run Usergrid from the command-line from the
+jar in the usergrid/standalone project:
+
+ cd launcher; java -jar target/usergrid-launcher-*.jar
+
+After startup, your instance will be available on localhost, port 8080.
+To check it’s running properly, you can try loading our status page:
+
+ curl http://localhost:8080/status
+
+You can also run it as a webapp in Tomcat, by deploying the ROOT.war file generated in the usergrid/rest project.
+
+## Getting Started with the HTTP API
+
+Start by creating an Organization. It’s the top-level structure in Usergrid:
+all Apps and Administrators must belong to an Organization. Here’s how you create one:
+
+ curl -X POST \
+ -d 'organization=myfirstorg&username=myadmin&name=Admin&email=admin@example.com&password=password' \
+ http://localhost:8080/management/organizations
+
+You can see that creating an Organization creates an Administrator in the process. Let’s authenticate as him:
+
+ curl 'http://localhost:8080/management/token?grant_type=password&username=myadmin&password=password'
+
+This will return an access\_token. We’ll use this to authenticate the next two calls.
+Next, let’s create an Application:
+
+ curl -H "Authorization: Bearer [the management token from above]" \
+ -H "Content-Type: application/json" \
+ -X POST -d '{ "name":"myapp" }' \
+ http://localhost:8080/management/orgs/myfirstorg/apps
+
+… And a User for the Application:
+
+ curl -H "Authorization: Bearer [the management token from above]" \
+ -X POST "http://localhost:8080/myfirstorg/myapp/users" \
+ -d '{ "username":"myuser", "password":"mypassword", "email":"user@example.com" }'
+
+Let’s now generate an access token for this Application User:
+
+ curl 'http://localhost:8080/myfirstorg/myapp/token?grant_type=password&username=myuser&password=mypassword'
+
+This will also send back an access\_token, but limited in scope.
+Let’s use it to create a collection with some data in it:
+
+ curl -H "Authorization: Bearer [the user token]" \
+ -X POST -d '[ { "cat":"fluffy" }, { "fish": { "gold":2, "oscar":1 } } ]' \
+ http://localhost:8080/myfirstorg/myapp/pets
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/installation/getting-up-and-running-locally.md
----------------------------------------------------------------------
diff --git a/docs/installation/getting-up-and-running-locally.md b/docs/installation/getting-up-and-running-locally.md
deleted file mode 100644
index ba7ffcc..0000000
--- a/docs/installation/getting-up-and-running-locally.md
+++ /dev/null
@@ -1,72 +0,0 @@
-# Getting Up & Running Locally
-
-## Requirements
-
-* [JDK 1.7](http://www.oracle.com/technetwork/java/javase/downloads/index.html)
-* [Maven](http://maven.apache.org/)
-
-## Download
-
-### Download2
-
-Start by [downloading our latest code](https://github.com/apache/incubator-usergrid/archive/master.zip) and extract it.
-
-#### Building 3
-
-From the command line, navigate to stack directory and type the following:
-
- mvn clean install -DskipTests=true
-
-## Running
-
-Usergrid-core contains the persistence layer and shared utilities for powering the Usergrid service. The services layer is contained in usergrid-services and exposes a higher-level API that's used by the usergrid-rest web services tier.
-
-You can run Usergrid from the command-line from the
-jar in the usergrid/standalone project:
-
- cd launcher; java -jar target/usergrid-launcher-*.jar
-
-After startup, your instance will be available on localhost, port 8080.
-To check it’s running properly, you can try loading our status page:
-
- curl http://localhost:8080/status
-
-You can also run it as a webapp in Tomcat, by deploying the ROOT.war file generated in the usergrid/rest project.
-
-## Getting Started with the HTTP API
-
-Start by creating an Organization. It’s the top-level structure in Usergrid:
-all Apps and Administrators must belong to an Organization. Here’s how you create one:
-
- curl -X POST \
- -d 'organization=myfirstorg&username=myadmin&name=Admin&email=admin@example.com&password=password' \
- http://localhost:8080/management/organizations
-
-You can see that creating an Organization creates an Administrator in the process. Let’s authenticate as him:
-
- curl 'http://localhost:8080/management/token?grant_type=password&username=myadmin&password=password'
-
-This will return an access\_token. We’ll use this to authenticate the next two calls.
-Next, let’s create an Application:
-
- curl -H "Authorization: Bearer [the management token from above]" \
- -H "Content-Type: application/json" \
- -X POST -d '{ "name":"myapp" }' \
- http://localhost:8080/management/orgs/myfirstorg/apps
-
-… And a User for the Application:
-
- curl -H "Authorization: Bearer [the management token from above]" \
- -X POST "http://localhost:8080/myfirstorg/myapp/users" \
- -d '{ "username":"myuser", "password":"mypassword", "email":"user@example.com" }'
-
-Let’s now generate an access token for this Application User:
-
- curl 'http://localhost:8080/myfirstorg/myapp/token?grant_type=password&username=myuser&password=mypassword'
-
-This will also send back an access\_token, but limited in scope.
-Let’s use it to create a collection with some data in it:
-
- curl -H "Authorization: Bearer [the user token]" \
- -X POST -d '[ { "cat":"fluffy" }, { "fish": { "gold":2, "oscar":1 } } ]' \
- http://localhost:8080/myfirstorg/myapp/pets
http://git-wip-us.apache.org/repos/asf/incubator-usergrid/blob/d2c7b377/docs/rest-endpoints/access-token.md
----------------------------------------------------------------------
diff --git a/docs/rest-endpoints/access-token.md b/docs/rest-endpoints/access-token.md
new file mode 100644
index 0000000..641ae47
--- /dev/null
+++ b/docs/rest-endpoints/access-token.md
@@ -0,0 +1,40 @@
+# access-token
+
+<!-- DO NOT EDIT THIS GENERATED FILE -->
+<table class='usergrid-table rest-endpoints-table'>
+ <tr>
+ <th>End-Point</th>
+ <th>Method</th>
+ <th>Content-type</th>
+ <th>Description</th>
+ <th>Detail</th>
+ </tr>
+ <tr>
+ <td>"/management/token '{"grant_type":"client_credentials","client_id":"{client_id}","client_secret":"{client_secret}"}'"</td>
+ <td>POST</td>
+ <td>application/json</td>
+ <td>Obtain an access token (access type = organization)</td>
+ <td>Detail</td>
+ </tr>
+ <tr>
+ <td>"/management/token '{"grant_type":"password","username":"{username}",:"password":"{password}"}'"</td>
+ <td>POST</td>
+ <td>application/json</td>
+ <td>Obtain an access token (access type = admin user)</td>
+ <td>Detail</td>
+ </tr>
+ <tr>
+ <td>"/{org_id}/{app_id}/token '{"grant_type":"client_credentials","client_id":"{client_id}","client_secret":"{client_secret}"}'"</td>
+ <td>POST</td>
+ <td>application/json</td>
+ <td>Obtain an access token (access type = application)</td>
+ <td>Detail</td>
+ </tr>
+ <tr>
+ <td>"/{org_id}/{app_id}/token '{"grant_type":"password","username":"{username}","password":"{password}"}'"</td>
+ <td>POST</td>
+ <td>application/json</td>
+ <td>Obtain an access token (access type = application user)</td>
+ <td>Detail</td>
+ </tr>
+</table>