docs: make Note more prominent

Author: kenjis

user_guide_src/source/general/common_functions.rst

@@ -374,6 +374,11 @@ Miscellaneous Functions
 
     .. note:: This function requires the controller/method to have a route defined in **app/Config/routes.php**.
 
+    .. important:: ``route_to()`` returns a *route*, not a full URI path for your site.
+        If your **baseURL** contains sub folders, the return value is not the same
+        as the URI to link. In that case, just use :php:func:`url_to()` instead.
+        See also :ref:`urls-url-structure`.
+
     Generates a route for you based on a controller::method combination. Will take parameters into effect, if provided.
 
     .. literalinclude:: common_functions/009.php
@@ -386,10 +391,6 @@ Miscellaneous Functions
 
     .. literalinclude:: common_functions/011.php
 
-    .. note:: ``route_to()`` returns a route, not a full URI path for your site.
-        If your **baseURL** contains sub folders, the return value is not the same
-        as the URI to link. In that case, just use :php:func:`url_to()` instead.
-
 .. php:function:: service($name[, ...$params])
 
     :param   string   $name: The name of the service to load

user_guide_src/source/general/urls.rst

@@ -15,6 +15,8 @@ Your URLs can be defined using the :doc:`URI Routing </incoming/routing>` featur
 
 The :doc:`URI Library <../libraries/uri>` and the :doc:`URL Helper <../helpers/url_helper>` contain functions that make it easy to work with your URI data.
 
+.. _urls-url-structure:
+
 URL Structure
 =============