[TASK] #102499 - User TSconfig setting "overridePageModule" removed (#…

…417)

Resolves: TYPO3-Documentation/Changelog-To-Doc#732
Releases: main

Documentation/UserTsconfig/Options.rst

@@ -796,31 +796,41 @@ noThumbsInEB
     If set, then image thumbnails are not shown in the element browser.
 
 
-..  todo:: can we remove this?
 ..  _useroptions-overridePageModule:
 
 overridePageModule
 ------------------
 
-..  confval:: overridePageModule
-
-    :Data type: string
-
-    By this value you can substitute the default :guilabel:`Web > Page` module
-    key ("web\_layout") with another backend module key.
-
-    ..  note::
-        This property has been introduced for EXT:templavoila in the old days.
-        It is of little use nowadays and can be achieved using
-        :ref:`hideModules <useroptions-hideModules>`, too.
-
-    Example:
-
-    ..  code-block:: typoscript
-        :caption: EXT:site_package/Configuration/user.tsconfig
-
-        # Enable TemplaVoila page module as default page module.
-        options.overridePageModule = web_txtemplavoilaM1
+..  versionchanged:: 13.0
+    This setting has been removed.
+
+Migration
+~~~~~~~~~
+
+In order to replace the :guilabel:`Web > Page` module within a third-party
+extension, such as TemplaVoila, it is possible to create a custom module entry
+in an extension's :file:`Configuration/Backend/Modules.php` with the following
+entry:
+
+..  code-block:: php
+    :caption: EXT:my_extension/Configuration/Backend/Modules.php
+
+    return [
+        'my_module' => [
+            'parent' => 'web',
+            'position' => ['before' => '*'],
+            'access' => 'user',
+            'aliases' => ['web_layout'],
+            'path' => '/module/my_module',
+            'iconIdentifier' => 'module-page',
+            'labels' => 'LLL:EXT:backend/Resources/Private/Language/locallang_mod.xlf',
+            'routes' => [
+                '_default' => [
+                    'target' => \MyVendor\MyExtension\Controller\MyController::class . '::mainAction',
+                ],
+            ],
+        ],
+    ];
 
 
 ..  index:: Page tree