docs: improve descriptions in Factories

Author: kenjis

user_guide_src/source/concepts/factories.rst

@@ -4,7 +4,7 @@ Factories
 
 .. contents::
     :local:
-    :depth: 2
+    :depth: 3
 
 Introduction
 ************
@@ -41,17 +41,14 @@ On the other hand, Services have code to create instances, so it can create a co
 that needs other services or class instances. When you get a service, Services require a service name,
 not a class name, so the returned instance can be changed without changing the client code.
 
+.. _factories-loading-class:
+
 Loading Classes
 ***************
 
 Loading a Class
 ===============
 
-.. _factories-example:
-
-Model Example
--------------
-
 Take a look at **Models** as an example. You can access the Factory specific to Models
 by using the magic static method of the Factories class, ``Factories::models()``.
 
@@ -64,7 +61,17 @@ In the following code, if you have ``App\Models\UserModel``, the instance will b
 
 .. literalinclude:: factories/001.php
 
-Or you could also request a specific class:
+If you don't have ``App\Models\UserModel``, it searches for ``Models\UserModel`` in all namespaces.
+
+Next time you ask for the same class anywhere in your code, Factories will be sure
+you get back the instance as before:
+
+.. literalinclude:: factories/003.php
+
+preferApp option
+----------------
+
+You could also request a specific class:
 
 .. literalinclude:: factories/002.php
    :lines: 2-
@@ -78,13 +85,6 @@ If you want to get ``Blog\Models\UserModel``, you need to disable the option ``p
 .. literalinclude:: factories/010.php
    :lines: 2-
 
-See :ref:`factories-options` for the details.
-
-Next time you ask for the same class anywhere in your code, Factories will be sure
-you get back the instance as before:
-
-.. literalinclude:: factories/003.php
-
 Loading a Class in Sub-directories
 ==================================
 

user_guide_src/source/concepts/factories/002.php

@@ -1,3 +1,5 @@
 <?php
 
 $users = Factories::models('Blog\Models\UserModel');
+// Or
+$users = Factories::models(\Blog\Models\UserModel::class);

user_guide_src/source/general/common_functions.rst

@@ -110,7 +110,7 @@ Service Accessors
     More simple way of getting model instances.
 
     The ``model()`` uses ``Factories::models()`` internally.
-    See :ref:`factories-example` for details on the first parameter ``$name``.
+    See :ref:`factories-loading-class` for details on the first parameter ``$name``.
 
     See also the :ref:`Using CodeIgniter's Model <accessing-models>`.
 

user_guide_src/source/general/modules.rst

@@ -194,7 +194,7 @@ Config files are automatically discovered whenever using the ``config()`` functi
 
 .. note:: ``config()`` finds the file in **app/Config/** when there is a class with the same shortname,
     even if you specify a fully qualified class name like ``config(\Acme\Blog\Config\Blog::class)``.
-    This is because ``config()`` is a wrapper for the ``Factories`` class which uses ``preferApp`` by default. See :ref:`Factories Example <factories-example>` for more information.
+    This is because ``config()`` is a wrapper for the ``Factories`` class which uses ``preferApp`` by default. See :ref:`factories-loading-class` for more information.
 
 Migrations
 ==========
@@ -250,7 +250,7 @@ Model files are automatically discovered whenever using the :php:func:`model()`
 
 .. note:: ``model()`` finds the file in **app/Models/** when there is a class with the same shortname,
     even if you specify a fully qualified class name like ``model(\Acme\Blog\Model\PostModel::class)``.
-    This is because ``model()`` is a wrapper for the ``Factories`` class which uses ``preferApp`` by default. See :ref:`Factories Example <factories-example>` for more information.
+    This is because ``model()`` is a wrapper for the ``Factories`` class which uses ``preferApp`` by default. See :ref:`factories-loading-class` for more information.
 
 Views
 =====

user_guide_src/source/models/model.rst

@@ -29,7 +29,7 @@ You can access models within your classes by creating a new instance or using th
 .. literalinclude:: model/001.php
 
 The ``model()`` uses ``Factories::models()`` internally.
-See :ref:`factories-example` for details on the first parameter.
+See :ref:`factories-loading-class` for details on the first parameter.
 
 CodeIgniter's Model
 *******************