Skip to content
Browse files

Merge pull request #340 from cordoval/patch-10

Update Resources/doc/5-automatic-route-generation_single-restful-control...
  • Loading branch information...
2 parents 8c1540d + 2d1b3b1 commit 1b9941e47505474eed81f892f27d0a332afeacec @lsmith77 lsmith77 committed Dec 7, 2012
Showing with 10 additions and 3 deletions.
  1. +10 −3 Resources/doc/5-automatic-route-generation_single-restful-controller.md
View
13 Resources/doc/5-automatic-route-generation_single-restful-controller.md
@@ -22,6 +22,11 @@ https://github.com/liip/LiipHelloBundle/blob/master/Controller/RestController.ph
Single RESTful controller routes
================================
+Single as opposed to multiple is just the focus of our routes, that is whether they are referring
+to just one resource without subresources or to resources that have subresources. The resource
+routes in the second case is described a bit different and is seen in the next section. Now we
+turn to simple resource routes.
+
```yaml
# app/config/routing.yml
users:
@@ -31,9 +36,11 @@ users:
This will tell Symfony2 to automatically generate proper REST routes from your ``UsersController`` action names.
Notice ``type: rest`` option. It's required so that the RestBundle can find which routes are supported.
-Notice ``name_prefix: <my_bundle_>`` option. It's useful to prefix the generated controller routes to organize
-your several resources paths. Take care that you can use ``name_prefix`` on an import only when the file is
-imported itself with the type ``rest``. You can also set a parent and a regular prefix as well as any other route.
+
+Notice the ``name_prefix: my_bundle_`` option. It's useful to prefix the generated controller routes to organize
+your several resources paths. Take care that you can use ``name_prefix`` on an import only when the file is imported
+itself with the type ``rest``. The parent option is used in subresources as we will see in the next section for
+multiple RESTful controller routes.
## Define resource actions

0 comments on commit 1b9941e

Please sign in to comment.
Something went wrong with that request. Please try again.