docs: update docs

Author: kenjis

user_guide_src/source/changelogs/v4.4.0.rst

@@ -88,11 +88,10 @@ Others
   the ``Content-Disposition: inline`` header to display the file in the browser.
   See :ref:`open-file-in-browser` for details.
 - **View:** Added optional 2nd parameter ``$saveData`` on ``renderSection()`` to prevent from auto cleans the data after displaying. See :ref:`View Layouts <creating-a-layout>` for details.
-- **Auto Routing (Improved):** Now you can pass arguments to the the default
-  controller that is omitted in the URI.
-  See :ref:`controller-default-controller-fallback` for details.
-- **Auto Routing (Improved):** Now you can use URI without a method name like
-  ``product/15`` where ``15`` is an arbitrary number.
+- **Auto Routing (Improved):** If a controller is found that corresponds to a URI
+  segment and that controller does not have a method defined for the URI segment,
+  the default method will now be executed. This addition allows for more flexible
+  handling of URIs in auto routing.
   See :ref:`controller-default-method-fallback` for details.
 - **Filters:** Now you can use Filter Arguments with :ref:`$filters property <filters-filters-filter-arguments>`.
 - **Request:** Added ``IncomingRequest::setValidLocales()`` method to set valid locales.

user_guide_src/source/incoming/controllers.rst

@@ -274,17 +274,33 @@ Your method will be passed URI segments 3 and 4 (``'sandals'`` and ``'123'``):
 
 .. literalinclude:: controllers/022.php
 
-.. _controller-default-controller-fallback:
+.. _controller-default-method-fallback:
 
-Default Controller Fallback
-===========================
+Default Method Fallback
+=======================
 
 .. versionadded:: 4.4.0
 
+If the controller method corresponding to the URI segment of the method name
+does not exist, and if the default method is defined, the remaining URI segments
+are passed to the default method for execution.
+
+.. literalinclude:: controllers/024.php
+
+Load the following URL::
+
+    example.com/index.php/product/15/edit
+
+The method will be passed URI segments 2 and 3 (``'15'`` and ``'edit'``):
+
+.. important:: If there are more parameters in the URI than the method parameters,
+    Auto Routing (Improved) does not execute the method, and it results in 404
+    Not Found.
+
 If the controller corresponding to the URI segment of the controller name
 does not exist, and if the default controller (``Home`` by default) exists in
-the directory, the remaining URI segments are passed to the default controller
-for execution.
+the directory, the remaining URI segments are passed to the default controller's
+default method.
 
 For example, when you have the following default controller ``Home`` in the
 **app/Controllers/News** directory:
@@ -293,48 +309,19 @@ For example, when you have the following default controller ``Home`` in the
 
 Load the following URL::
 
-    example.com/index.php/news/list
+    example.com/index.php/news/101
 
-The ``News\Home`` controller will be found, and the ``getList()`` method will be
-executed.
+The ``News\Home`` controller and the default ``getIndex()`` method will be found.
+So the default method will be passed URI segments 2 (``'101'``):
 
 .. note:: If there is ``App\Controllers\News`` controller, it takes precedence.
     The URI segments are searched sequentially and the first controller found
     is used.
 
-Load the following URL::
-
-    example.com/index.php/news/101
-
-The default ``getIndex()`` method will be passed URI segments 2 (``'101'``):
-
 .. note:: If there are more parameters in the URI than the method parameters,
     Auto Routing (Improved) does not execute the method, and it results in 404
     Not Found.
 
-.. _controller-default-method-fallback:
-
-Default Method Fallback
-=======================
-
-.. versionadded:: 4.4.0
-
-If the controller method corresponding to the URI segment of the method name
-does not exist, and if the default method is defined, the remaining URI segments
-are passed to the default method for execution.
-
-.. literalinclude:: controllers/024.php
-
-Load the following URL::
-
-    example.com/index.php/product/15/edit
-
-The method will be passed URI segments 2 and 3 (``'15'`` and ``'edit'``):
-
-.. important:: If there are more parameters in the URI than the method parameters,
-    Auto Routing (Improved) does not execute the method, and it results in 404
-    Not Found.
-
 Default Controller
 ==================
 

user_guide_src/source/incoming/controllers/025.php

@@ -6,11 +6,6 @@
 
 class Home extends BaseController
 {
-    public function getList()
-    {
-        // ...
-    }
-
     public function getIndex($id = null)
     {
         // ...