Task #92196
closed
Do not render all changelogs for all versions
0%
Description
The changelogs are used in the extension scanner etc. so older changelogs must also exist in newer versions.
That does not mean they have to be rendered for every version.
The current practice of rendering all available changelogs has 2 disadvantages:
- the rendering takes very long (currently causing it to timeout on the docs server). This makes it more difficult to test changes because you have to wait for the rendering to finish.
- changelogs are being rendered multiple times which is not really necessary and results in duplicated content:
- `https://docs.typo3.org/c/typo3/cms-core/master/en-us/Changelog/7.6.x/Breaking-72931-SearchFormControllerpi_list_browseresultsHasBeenRenamed.html`
- `https://docs.typo3.org/c/typo3/cms-core/master/en-us/Changelog/8.1/Breaking-72931-SearchFormControllerpi_list_browseresultsHasBeenRenamed.html`
Excluding specific .rst files from rendering can be handled by specifying a jobfile, see https://github.com/t3docs/docker-render-documentation/issues/86
Updated by Gerrit Code Review over 3 years ago
- Status changed from New to Under Review
Patch set 1 for branch master of project Packages/TYPO3.CMS has been pushed to the review server.
It is available at https://review.typo3.org/c/Packages/TYPO3.CMS/+/65577
Updated by Gerrit Code Review over 3 years ago
Patch set 2 for branch master of project Packages/TYPO3.CMS has been pushed to the review server.
It is available at https://review.typo3.org/c/Packages/TYPO3.CMS/+/65577
Updated by Gerrit Code Review over 3 years ago
Patch set 3 for branch master of project Packages/TYPO3.CMS has been pushed to the review server.
It is available at https://review.typo3.org/c/Packages/TYPO3.CMS/+/65577
Updated by Gerrit Code Review over 3 years ago
Patch set 4 for branch master of project Packages/TYPO3.CMS has been pushed to the review server.
It is available at https://review.typo3.org/c/Packages/TYPO3.CMS/+/65577
Updated by Gerrit Code Review over 3 years ago
Patch set 5 for branch master of project Packages/TYPO3.CMS has been pushed to the review server.
It is available at https://review.typo3.org/c/Packages/TYPO3.CMS/+/65577
Updated by Sybille Peters about 3 years ago
- Status changed from Under Review to Closed
Updated by Sybille Peters about 3 years ago
I am closing this issue. The review is abandoned: https://review.typo3.org/c/Packages/TYPO3.CMS/+/65577
There are a number of reasons why currenty practice of rendering of all versions in the changelog are awkward:
1. Multiple URLs: all versions are included and rendered in current and next branches. This results in multiple URLs, e.g.
https://docs.typo3.org/c/typo3/cms-core/master/en-us/Changelog/9.5.x/Feature-86740-AllowRemovalOfSlashInSlug.html
https://docs.typo3.org/c/typo3/cms-core/10.4/en-us/Changelog/9.5.x/Feature-86740-AllowRemovalOfSlashInSlug.html
https://docs.typo3.org/c/typo3/cms-core/9.5/en-us/Changelog/9.5.x/Feature-86740-AllowRemovalOfSlashInSlug.html
2. Can't search for current version - the search on https://docs.typo3.org/c/typo3/cms-core/9.5/en-us/Index.html will search through all versions, no matter what version you are in
3. Can't (easily) create an index for the changelog - because it will include all versions (same problem as search)
4. Rendering speed - escpecially relevant for local rendering.
There is not any progress on this and some of these problems may take care of themselves with the global search engine.