Skip to content

Commit 05559a5

Browse files
authored
Update Index.rst ("Maintaining TYPO3")
fix grammar, typos and "here" links
1 parent 8667afd commit 05559a5

File tree

1 file changed

+28
-29
lines changed

1 file changed

+28
-29
lines changed

Documentation/Installation/Updates/Index.rst

Lines changed: 28 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@ When and why should we perform TYPO3 updates?
1717
With the newest version of TYPO3 you receive free bugfixes and free security patches
1818
for at least three years from the time of the first LTS minor (for example v13.1) release.
1919

20-
In TYPO3 however, we follow a specific cycle which usually takes 1.5 years long. Every
21-
1 and a half year a new TYPO3 version occurs. You can follow the cycle `here <https://typo3.org/cms/roadmap>`__.
20+
In TYPO3 however, we follow a specific `cycle <https://typo3.org/cms/roadmap>`__ which usually takes 1.5 years long. Every
21+
1 and a half year a new TYPO3 version occurs.
2222

2323
We explain the different parts in the `roadmap <https://typo3.org/cms/roadmap>`__ now.
2424
When you follow the roadmap you see dark red strokes. They represent the **sprint releases**.
@@ -39,7 +39,7 @@ we summaries how a TYPO3 user should act with respect to TYPO3 updates:
3939

4040
* When a new major LTS version is released, users **should** focus on updating to this version as soon as possible.
4141
* When a new minor version is released, users **must** update to the new minor version, since the previous minor version is **not** supported any more.
42-
* When a new patch level version is released, users should always update to the new version, because it contains important bugfixes and security fixes (if announced). Here you find the `security advisories <https://typo3.org/help/security-advisories>`__.
42+
* When a new patch level version is released, users **should** always update to the new version, because it contains **important** bugfixes and security fixes (if announced). Here you find the `security advisories <https://typo3.org/help/security-advisories>`__.
4343

4444
Additionally, users should take care of updated extensions on a regular schedule
4545
in order to use the most recent versions.
@@ -57,17 +57,17 @@ Major, minor and patch level updates
5757
In TYPO3 you can update your TYPO3 version. There exist three different types
5858
of updates:
5959

60-
#. Major updates: from for example 12.4.23 to 13.0.0
61-
#. Minor updates: from for example 13.0 to 13.1
62-
#. Patch and bugfix level updates (often security updates): from for example 13.4.0 to 13.4.1
60+
#. Major updates: for example, from 12.4.23 to 13.0.0
61+
#. Minor updates: for example, from 13.0 to 13.1
62+
#. Patch and bugfix level updates (often security updates): for example, from 13.4.0 to 13.4.1
6363

6464

6565
.. _getting-started-major-typo3-updates:
6666

6767
Major updates
6868
-------------
6969

70-
In major updates you will definitely have breaking changes and incompatible API
70+
In major updates you will definitely have **breaking changes** and incompatible API
7171
changes.
7272
A breaking change can cause your system to break. You need to find a replacement
7373
for any usage that was removed or changed. For example in version 13.0 was a
@@ -88,12 +88,12 @@ Minor updates
8888
-------------
8989

9090
Minor changes - `11.*.2`: For example 11.5 has new functionalities compared to
91-
11.4. The version 11.5 is compatible with 11. So withing a version like major
92-
11 the steps do not lead to breaking changes. For example in version 13.3
91+
11.4. The version 11.5 is compatible with 11. So within a version like major
92+
11, the steps do not lead to breaking changes. For example in version 13.3
9393
compared to version 13.2 a new
9494
:ref:`Feature: #101252 - Introduce ErrorHandler for 403 errors with redirect option <changelog:feature-101252-1715447531>`
9595
was introduced.
96-
When performing minor updates you often have to clear the cache, run the Upgrade wizard and to run a database compare.
96+
When performing minor updates, you often have to clear the cache, run the Upgrade wizard, and run a database compare.
9797
Usually minor and patch changes are also referred to as **non-breaking** changes.
9898

9999
.. _getting-started-patchlevel-typo3-updates:
@@ -102,21 +102,21 @@ Patchlevel updates
102102
------------------
103103

104104
Patchlevel changes - `11.5.*`: The version 11.5.2 indicates a backwards-compatible bugfix or patch release.
105-
It can be for example a security update. Clear the cache and check if website is working as expected. For further
106-
information we refer to the :ref:`Patch/Bugfix update guide<t3coreapi:minor>`.
105+
It can be for example a security update. Clear the cache and check if the website is working as expected. For
106+
further information we refer to the :ref:`Patch/Bugfix update guide<t3coreapi:minor>`.
107107

108108
.. _getting-started-extension-updates:
109109

110110
Extension updates
111111
=================
112112

113-
In a TYPO3 instance you have usually third party extensions installed. When you update your TYPO3 version you
114-
have to update the third party extensions too. In the **TYPO3 Extension Repository (TER)** you can enter the name of
115-
that extension and get information about supported TYPO3 versions. You find the TER `here <https://extensions.typo3.org/>`__.
113+
In a TYPO3 instance you have usually third party extensions installed. When you update your TYPO3 version, you
114+
have to update the third-party extensions too. In the **`TYPO3 Extension Repository (TER) <https://extensions.typo3.org/>`__**
115+
you can enter the name of that extension and get information about supported TYPO3 versions.
116116
Some extension authors prefer to only publish their extensions on `packagist <https://packagist.org/packages/typo3/>`__.
117117
When the extension does not exist for the current TYPO3 version you can create an
118118
issue or search for an alternative extension offering the same functionality.
119-
For example the `gridelements extension<https://extensions.typo3.org/extension/gridelements>`__
119+
For example, the `gridelements extension<https://extensions.typo3.org/extension/gridelements>`__
120120
was replaced by the `container extension<https://extensions.typo3.org/extension/container>`__, both
121121
having equal functionalities.
122122

@@ -129,30 +129,29 @@ Deprecations
129129

130130
In TYPO3, deprecations indicate that a specific functionality will be removed in the next TYPO3 version. For further
131131
information we refer to the :ref:`article about deprecation <t3coreapi:deprecation>`. For example the
132-
:ref:`deprecation: #105171 - INCLUDE_TYPOSCRIPT TypoScript syntax <changelog:deprecation-105171-1727785626>`- notice is
133-
a deprecation notice telling you that in TYPO3 v14 you can't use the TypoScript syntax :typoscript:`INCLUDE_TYPOSCRIPT`
134-
to include TypoScript files anymore.
132+
:ref:`deprecation: #105171 - INCLUDE_TYPOSCRIPT TypoScript syntax <changelog:deprecation-105171-1727785626>` - a deprecation
133+
notice telling you that in TYPO3 v14 you can't use the TypoScript syntax :typoscript:`INCLUDE_TYPOSCRIPT` to include TypoScript files anymore.
135134

136135
.. _getting-started-little-helpers:
137136

138137
Little Helpers: Rector and Fractor
139138
==================================
140139

141-
In general you can use extensions like `rector <https://github.com/sabbelasichon/typo3-rector/blob/main/README.md>`__
142-
or `fractor <https://github.com/andreaswolf/fractor>`__ to find and replace deprecations. To reach this you have to
143-
fill out a configuration file (in rector file :file:`rector.php`, in fractor file :file:`fractor.php`) that defines
144-
the scope in which you want to perform deprecation replacements. For both extension is valid, only the rules that
145-
exist can find the respective deprecation. Here is an overview about the
146-
`existing rector rules <https://github.com/sabbelasichon/typo3-rector/blob/main/docs/all_rectors_overview.md>`__.
147-
When a rule is missing you can't find the deprecation. Check `here <https://getrector.com/find-rule>`__ if your desired
148-
rector rule exists already. If you feel able to create your own rector or fractor rule and want to share it with the TYPO3
149-
community, everyone using these tools would be happy to benefit from your efforts.
140+
In general you can use extensions like `Rector <https://github.com/sabbelasichon/typo3-rector>`__
141+
or `Fractor <https://github.com/andreaswolf/fractor>`__ to find and replace deprecations. To reach this, you have to
142+
fill out a configuration file (in Rector :file:`rector.php`, in Fractor :file:`fractor.php`) that defines
143+
the scope in which you want to **perform deprecation replacements**. For both extensions, only the rules that
144+
exist can find the respective deprecation. For instance, check the
145+
`overview of existing rules for Rector <https://github.com/sabbelasichon/typo3-rector/blob/main/docs/all_rectors_overview.md>`__
146+
or `search for your desired Rector rule <https://getrector.com/find-rule>`__ if it already exists. When a rule is missing, you can't
147+
find the deprecation using the extension. If you feel able to create your own Rector or Fractor rule and want to share
148+
it with the TYPO3 community, everyone using these tools would be happy to benefit from your efforts.
150149

151150
.. _getting-started-language-updates:
152151

153152
Language updates
154153
================
155154

156-
After a TYPO3 update you have to update your translations. We refer to the article
155+
After a TYPO3 update, you have to update your translations. We refer to the article
157156
:ref:`Update backend translations <t3coreapi:update_backend_translation>`. You have to update the language packs that
158157
you are using after each TYPO3 update.

0 commit comments

Comments
 (0)