From c0bf3f2265c75ee78f64caebc5e31d917880719c Mon Sep 17 00:00:00 2001 From: "lina.wolf" Date: Mon, 11 May 2026 12:50:55 +0200 Subject: [PATCH 1/3] [TASK] Update documentation for new major LTS version Restructure and expand instructions for creating branches, adding eLTS warnings, updating start pages, and setting API & render guide configurations for the new TYPO3 LTS version. --- .../Maintainers/NewMajorCoreVersion.rst | 113 ++++++++++++++++-- 1 file changed, 105 insertions(+), 8 deletions(-) diff --git a/Documentation/Maintainers/NewMajorCoreVersion.rst b/Documentation/Maintainers/NewMajorCoreVersion.rst index 1f1cae1..df1b2df 100644 --- a/Documentation/Maintainers/NewMajorCoreVersion.rst +++ b/Documentation/Maintainers/NewMajorCoreVersion.rst @@ -1,22 +1,119 @@ .. include:: /Includes.rst.txt .. _new-major-core-versions: -================================== -New major Core version is released -================================== +================================================= +Branching of the docs for a new major LTS version +================================================= .. contents:: +Create branches for the new LTS version in all versioned official repositories +============================================================================== + +This includes all manuals in the "All Documentation" menu with version hints, +excluding the System extension manuals. The System extension manuals will +receive their new versions automatically via webhook in the release. This might +take a few days, though. + +* Create a new branch called, for example, `14.3`. +* Limit the composer.json to that version. For example `"typo3/cms-core": "^14.3"` + instead of `"typo3/cms-core": "dev-main as 14.3"` and make sure `composer update` + works. +* Set the release and version to the new minor version, for example + + .. code-block:: xml + :caption: Documentation/guides.xml + + + +**After all the new LTS branches have been created and rendered** for all repositories +revisit the guides.xml in all new LTS branches and raise the preferred typo3 version: + +.. code-block:: xml + :caption: Documentation/guides.xml + :emphasize-lines: 9 + + + +We usually leave the `edit-on-github-branch` on main to avoid people making PRs +against the LTS branch and to avoid confusion in our backport workflows. + +.. _new-major-core-versions-elts: + +Add new eLTS warnings to the newly created eLTS version +======================================================= + +Add a warning to the `Documentation/Includes.rst.txt` of the branch for the +new eLTS versions of all repositories: + +.. code-block:: rst + :caption: Documentation/Includes.rst.txt + + .. You can put central messages to display on all pages here + + .. attention:: + TYPO3 v11 has reached end-of-life as of April 30th 2026 and + is no longer being maintained. Use the version switcher on the top + left of this page to select documentation for a supported version of TYPO3. + + Need more time before upgrading? + You can purchase Extended Long Term Support (ELTS) for TYPO3 v12 here: + `TYPO3 ELTS `__. + +.. _new-major-core-versions-startpage: + +Update the start page docs.typo3.org for a new major version +============================================================ + +* Add the new major version to the main menu: + https://github.com/TYPO3-Documentation/DocsTypo3Org-Homepage/blob/main/Documentation/_mainMenu.rst.txt + Remove the versions that are now ELTS. +* Add the new API version to the main menu +* Require the latest LTS version in the + https://github.com/TYPO3-Documentation/DocsTypo3Org-Homepage/blob/main/composer.json .. _new-major-core-versions-api: Update api.typo3.org for a new major version ============================================ -* Add the new TYPO3 LTS version for rendering into +* Add the new TYPO3 LTS version for rendering into https://github.com/TYPO3-Documentation/t3docs-ci-deploy/blob/main/.github/workflows/api-typo3-org.yml#L13 -* Add the new TYPO3 Version to the sidebar of api.typo3.org: +* Add the new TYPO3 version to the sidebar of api.typo3.org: https://github.com/TYPO3-Documentation/render-guides/blob/main/packages/typo3-api/template/components/sidebar.html.twig#L9 -* Trigger rendering of the api, by triggering above workflow -* Add the new version to the api.typo3.org startpage: https://github.com/TYPO3-Documentation/DocsTypo3Org-Homepage/blob/main/WebRootResources-api.typo3.org/index.html -* Add the new Version to the main Menu: http://github.com/TYPO3-Documentation/DocsTypo3Org-Homepage/blob/main/Documentation/_mainMenu.rst.txt +* Trigger rendering of the API by running the workflow mentioned above +* Add the new version to the api.typo3.org start page: https://github.com/TYPO3-Documentation/DocsTypo3Org-Homepage/blob/main/WebRootResources-api.typo3.org/index.html +* Add the new version to the main menu: http://github.com/TYPO3-Documentation/DocsTypo3Org-Homepage/blob/main/Documentation/_mainMenu.rst.txt + +.. _new-major-core-versions-renderguides: + +Set the "stable" version for links to the new LTS version in renderguides +========================================================================= + +You should only do this after all versioned repositories exist in the new LTS +version and have been rendered; otherwise, rendering links will fail in all +manuals that are newly rendered. Then create a new renderguides release by +creating a tag for the version. + +.. _new-major-core-versions-search: + +Make the new LTS version the preferred result in the docs search +================================================================ + +Require the newly created version of `t3docs/typo3-version-handling`, which was +created by the renderguides release in https://github.com/TYPO3-Documentation/t3docs-search-indexer +and make a new release of the search. From 1617293692207c2c67797addfc88ea379ab55119 Mon Sep 17 00:00:00 2001 From: Lina Wolf <48202465+linawolf@users.noreply.github.com> Date: Mon, 11 May 2026 13:02:35 +0200 Subject: [PATCH 2/3] Add reference link for creating renderguides release Added a reference link to an example for creating a new renderguides release. --- Documentation/Maintainers/NewMajorCoreVersion.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/Maintainers/NewMajorCoreVersion.rst b/Documentation/Maintainers/NewMajorCoreVersion.rst index df1b2df..cd888ac 100644 --- a/Documentation/Maintainers/NewMajorCoreVersion.rst +++ b/Documentation/Maintainers/NewMajorCoreVersion.rst @@ -107,7 +107,8 @@ Set the "stable" version for links to the new LTS version in renderguides You should only do this after all versioned repositories exist in the new LTS version and have been rendered; otherwise, rendering links will fail in all manuals that are newly rendered. Then create a new renderguides release by -creating a tag for the version. +creating a tag for the version. See https://github.com/TYPO3-Documentation/render-guides/pull/1246 +for an example. .. _new-major-core-versions-search: From fd502c02481b73168164aef4aab015e52df9d29d Mon Sep 17 00:00:00 2001 From: Sarah McCarthy Date: Mon, 11 May 2026 14:32:43 +0200 Subject: [PATCH 3/3] [TASK] Language checks --- .../Maintainers/NewMajorCoreVersion.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/Documentation/Maintainers/NewMajorCoreVersion.rst b/Documentation/Maintainers/NewMajorCoreVersion.rst index cd888ac..5884b1c 100644 --- a/Documentation/Maintainers/NewMajorCoreVersion.rst +++ b/Documentation/Maintainers/NewMajorCoreVersion.rst @@ -13,9 +13,9 @@ Create branches for the new LTS version in all versioned official repositories This includes all manuals in the "All Documentation" menu with version hints, excluding the System extension manuals. The System extension manuals will receive their new versions automatically via webhook in the release. This might -take a few days, though. +take a few days. -* Create a new branch called, for example, `14.3`. +* Create a new branch. `14.3` in this example. * Limit the composer.json to that version. For example `"typo3/cms-core": "^14.3"` instead of `"typo3/cms-core": "dev-main as 14.3"` and make sure `composer update` works. @@ -30,8 +30,8 @@ take a few days, though. copyright="since 2012 by the TYPO3 contributors" /> -**After all the new LTS branches have been created and rendered** for all repositories -revisit the guides.xml in all new LTS branches and raise the preferred typo3 version: +**After all the new LTS branches have been created and rendered** for all repositories, +revisit the guides.xml in all new LTS branches and raise to the preferred typo3 version: .. code-block:: xml :caption: Documentation/guides.xml @@ -83,7 +83,7 @@ Update the start page docs.typo3.org for a new major version https://github.com/TYPO3-Documentation/DocsTypo3Org-Homepage/blob/main/Documentation/_mainMenu.rst.txt Remove the versions that are now ELTS. * Add the new API version to the main menu -* Require the latest LTS version in the +* Require the latest LTS version in https://github.com/TYPO3-Documentation/DocsTypo3Org-Homepage/blob/main/composer.json .. _new-major-core-versions-api: @@ -95,7 +95,7 @@ Update api.typo3.org for a new major version https://github.com/TYPO3-Documentation/t3docs-ci-deploy/blob/main/.github/workflows/api-typo3-org.yml#L13 * Add the new TYPO3 version to the sidebar of api.typo3.org: https://github.com/TYPO3-Documentation/render-guides/blob/main/packages/typo3-api/template/components/sidebar.html.twig#L9 -* Trigger rendering of the API by running the workflow mentioned above +* Trigger rendering of the API by running the workflow above * Add the new version to the api.typo3.org start page: https://github.com/TYPO3-Documentation/DocsTypo3Org-Homepage/blob/main/WebRootResources-api.typo3.org/index.html * Add the new version to the main menu: http://github.com/TYPO3-Documentation/DocsTypo3Org-Homepage/blob/main/Documentation/_mainMenu.rst.txt @@ -115,6 +115,6 @@ for an example. Make the new LTS version the preferred result in the docs search ================================================================ -Require the newly created version of `t3docs/typo3-version-handling`, which was -created by the renderguides release in https://github.com/TYPO3-Documentation/t3docs-search-indexer +Require the newly created version of `t3docs/typo3-version-handling` +(created by the renderguides release in https://github.com/TYPO3-Documentation/t3docs-search-indexer) and make a new release of the search.