rest-api-standards.markdown

@@ -21,10 +21,9 @@
 |`GET`	   |	`/resources`                           |  get resource collection|
 |`GET`	   |	`/resources?filter={filter_param}`      |  get filtered resource collection|
 |`GET`	   |	`/resources/{id}`                      |  get single resource|
-|`GET`	   |	`/resources/{id}:(extra-property1)`    |  get single resource, requesting extra property|
+|`GET`	   |	`/resources/{id}:(extra-property1)`    |  get single resource, requesting extra property (can be a sub resource like  users:(addresses) or an extra property not included in the standard user entity like users:(active))|
 |`DELETE`  |	`/resources/{id}`                      |  delete single resource|
 |`DELETE`  |	`/resources/{id}?recursive=:boolean`   |  delete single resource, additional parameters in `GET` string|
 |`PATCH`   |	`/resources/{id}`                      |  update resource, properties in json payload|
 |`POST`	   |	`/resources/{id}/link`                 |  link resource to specified resource(s), in json payload []|
 |`POST`	   |	`/resources/{id}/unlink`               |  unlink resource to specified resource(s), in json payload []|
-