Merge pull request #8118 from cakephp/table-container

Add documentation for cakephp/cakephp#18979

Author: markstory

en/appendices/5-3-migration-guide.rst

@@ -148,6 +148,8 @@ ORM
   validation to the fields listed in the ``fields`` option.
 - Added ``TableContainer`` that you can register in your Application::services() to
   add dependency injection for your Tables.
+- ``Cake\ORM\Locator\TableContainer`` was added. By adding this container
+  delegate to your application, ORM Tables can be injected by the DI container.
 
 Routing
 -------

en/development/dependency-injection.rst

@@ -188,6 +188,19 @@ instance, often referred to as a singleton, you can mark a service as 'shared'::
 
     $container->addShared(BillingService::class);
 
+Using ORM Tables as Services
+----------------------------
+
+If you want to have ORM Tables injected as a dependency to a service, you can
+add ``TableContainer`` to your applications's service container::
+
+    // In your Application::services() method.
+    // Allow your Tables to be dependency injected.
+    $container->delegate(new \Cake\ORM\Locator\TableContainer());
+
+.. versionadded:: 5.3.0
+   ``TableContainer`` was added.
+
 Extending Definitions
 ---------------------