make comment on limit_candidates a caution

Author: dbu

bundles/routing/dynamic.rst

@@ -293,7 +293,7 @@ get an error if Sonata becomes unavailable.
 Sonata admin is using the ``content_basepath`` to show the tree of content to
 select the route target.
 
-The root path to add Routes defaults to the first entry in ``route_basepaths``
+The root path to add Routes defaults to the first entry in ``route_basepaths``,
 but you can overwrite this with the ``admin_basepath`` if you need a different
 base path.
 

bundles/simple_cms/rendering.rst

@@ -10,10 +10,6 @@ When you need specific settings for a single page, you can call
 ``setDefault()`` for the key ``_template`` or ``_controller`` default in the
 page instance.
 
- Alternatively one can
-configure the template and controller also via the SimpleCmsBundle
-:ref:`routing configuration <config-simple-cms-routing>`.
-
 A simple example for such a template could look like this:
 
 .. configuration-block::

reference/configuration/routing.rst

@@ -527,11 +527,14 @@ limit_candidates
 With this flag you can tune the routing behaviour when using the dynamic
 pattern part of routes stored in the database. If you do never use the variable
 pattern field of the Route model, you can set this to 1 as a small performance
-optimization.
+optimization. If you have very complex URLs with patterns, you might need to
+increase the limit.
 
-If you have very complex URLs with patterns, you might need to increase the
-limit, but this will expose your site to load attacks with URLs with lots of
-slashes in them.
+.. caution::
+
+    Setting this to a higher makes your site more vulnerable to load attacks
+    when someone visits your site with URLs with lots of slashes in them, since
+    every slash will lead to a document being tried to be loaded.
 
 match_implicit_locale
 ~~~~~~~~~~~~~~~~~~~~~