Skip to content

Commit a2fc131

Browse files
committed
docs: add more explanation and link
1 parent c802bd8 commit a2fc131

File tree

2 files changed

+6
-2
lines changed

2 files changed

+6
-2
lines changed

user_guide_src/source/concepts/factories.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,8 @@ to access user records always go through that connection::
5858
Now any time the ``UserModel`` is loaded from ``Factories`` it will in fact be returning a
5959
class instance that uses the alternate database connection.
6060

61+
.. _factories-options:
62+
6163
Factories Options
6264
==================
6365

user_guide_src/source/general/modules.rst

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -191,10 +191,12 @@ with the ``new`` command::
191191

192192
Config files are automatically discovered whenever using the **config()** function that is always available.
193193

194+
.. note:: We don't recommend you use the same short classname in modules.
195+
Modules that need to override or add to known configurations in **app/Config/** should use :ref:`registrars`.
196+
194197
.. note:: **config()** finds the file in **app/Config/** when there is a class with the same shortname,
195198
even if you specify a fully qualified class name like ``config(\Acme\Blog\Config\Blog::class)``.
196-
197-
.. note:: Modules that need to override or add to known configurations in **app/Config/** should use :ref:`registrars`.
199+
This is because ``Factories``'s the default configuration. See :ref:`factories-options` for more information.
198200

199201
Migrations
200202
==========

0 commit comments

Comments
 (0)