rest-api-standards.markdown

@@ -22,19 +22,8 @@
 |`DELETE`  |	`/resources/:id`                      |  delete single resource|
 |`DELETE`  |	`/resources/:id?recursive=:boolean`   |  delete single resource, additional parameters in get string|
 |`PATCH`   |	`/resources/:id`                      |  update resource|
-|`POST`	   |	`/resources/:id/link`                 |  link permission to specified role(s), payload []|
-|`POST`	   |	`/resources/:id/unlink`               |  unlink permission to specified role(s), payload []|
+|`POST`	   |	`/resources/:id/link`                 |  link resource to specified resource(s), in payload []|
+|`POST`	   |	`/resources/:id/unlink`               |  unlink resource to specified resource(s), in payload []|
 
 
 
-| HTTP     | Route                  | Action                    |
-| -------- | ---------------------- | ------------------------- |
-| `GET`    | `/resources`           | View all resources        |
-| `GET`    | `/resources/{id}`      | View single resource      |
-| `GET`    | `/resources/new`       | View create resource form |
-| `POST`   | `/resources`           | Store new resource        |
-| `GET`    | `/resources/{id}/edit` | View edit resource form   |
-| `PUT`    | `/resources/{id}`      | Update resource           |
-| `PATCH`  | `/resources/{id}`      | Update resource           |
-| `DELETE` | `/resources/{id}`      | Delete resource           |
-