docs: add changelog and upgrade guide

Author: kenjis

user_guide_src/source/changelogs/v4.4.0.rst

@@ -29,6 +29,35 @@ or more was specified. See :ref:`upgrade-440-uri-setsegment`.
 
 The next segment (``+1``) of the current last segment can be set as before.
 
+.. _v440-factories:
+
+Factories
+---------
+
+Passing Fully Qualified Classname
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Now ``preferApp`` works only when you request
+:ref:`a classname without a namespace <factories-passing-classname-without-namespace>`.
+
+For example, when you call ``model(\Myth\Auth\Models\UserModel::class)`` or
+``model('Myth\Auth\Models\UserModel')``:
+
+   - before:
+
+      - returns ``App\Models\UserModel`` if exists and ``preferApp`` is true (default)
+      - returns ``Myth\Auth\Models\UserModel`` if exists and ``preferApp`` is false
+
+   - after:
+
+      - returns ``Myth\Auth\Models\UserModel`` even if ``preferApp`` is true (default)
+      - returns ``App\Models\UserModel`` if you define ``Factories::define('models', 'Myth\Auth\Models\UserModel', 'App\Models\UserModel')`` before calling the ``model()``
+
+Property Name
+^^^^^^^^^^^^^
+
+The property ``Factories::$basenames`` has been renamed to ``$aliases``.
+
 .. _v440-interface-changes:
 
 Interface Changes
@@ -164,6 +193,8 @@ Others
 - **RedirectException:** can also take an object that implements ResponseInterface as its first argument.
 - **RedirectException:** implements ResponsableInterface.
 - **DebugBar:** Now :ref:`view-routes` are displayed in *DEFINED ROUTES* on the *Routes* tab.
+- **Factories:** You can now define the classname that will actually be loaded.
+  See :ref:`factories-defining-classname-to-be-loaded`.
 
 Message Changes
 ***************

user_guide_src/source/installation/upgrade_440.rst

@@ -73,6 +73,21 @@ This bug was fixed and now URIs for underscores (**foo_bar**) is not accessible.
 If you have links to URIs for underscores (**foo_bar**), update them with URIs
 for dashes (**foo-bar**).
 
+When Passing Fully Qualified Classnames to Factories
+====================================================
+
+The behavior of passing fully qualified classnames to Factories has been changed.
+See :ref:`ChangeLog <v440-factories>` for details.
+
+If you have code like ``model('\Myth\Auth\Models\UserModel::class')`` or
+``model('Myth\Auth\Models\UserModel')`` (the code may be in the third-party packages),
+and you expect to load your ``App\Models\UserModel``, you need to define the
+classname to be loaded before the first loading of that class::
+
+    Factories::define('models', 'Myth\Auth\Models\UserModel', 'App\Models\UserModel');
+
+See :ref:`factories-defining-classname-to-be-loaded` for details.
+
 Interface Changes
 =================