Skip to content

[BUGFIX] Fix broken changelog links in administration module badges - #824

Merged
linawolf merged 1 commit into
TYPO3-Documentation:mainfrom
CybotTM:bugfix/administration-modules-changelog-links
Jul 25, 2026
Merged

[BUGFIX] Fix broken changelog links in administration module badges#824
linawolf merged 1 commit into
TYPO3-Documentation:mainfrom
CybotTM:bugfix/administration-modules-changelog-links

Conversation

@CybotTM

@CybotTM CybotTM commented Jun 20, 2026

Copy link
Copy Markdown
Contributor

Problem

On https://docs.typo3.org/permalink/t3start:administration-modules the "Changed in version 14.0" badges render a raw URL as literal text with a stray trailing underscore instead of a working link.

The cause is malformed RST: the notes try to combine a :guilabel: role with an embedded hyperlink.

to :guilabel:`Administration <https://docs.typo3.org/permalink/changelog:feature-107628-1729026000>`_.

:guilabel: is not a reference role, so the `name <url>`_ embedded-URI syntax is not interpreted — the whole content is shown verbatim and the trailing _ is left dangling. Two of the blocks also indented the continuation line with a literal tab, and the Backend Users note wrongly read "moved from Administration to Administration".

Fix

Split the badge from the link in all four versionchanged blocks: keep :guilabel: for the menu labels and add a separate "the changelog entry" hyperlink. Fix the Backend Users wording to "System to Administration" and replace the stray tabs with spaces.

to :guilabel:`Administration`. See `the changelog entry
<https://docs.typo3.org/permalink/changelog:feature-107628-1729026000>`__.

Before / after

Top badge:

Top badge before and after

Backend Users badge (also fixes the "Administration → Administration" wording):

Backend Users badge before and after

Rendered locally with ghcr.io/typo3-documentation/render-guides:latest; no warnings.

The "Changed in version 14.0" notes tried to combine a :guilabel: role
with an embedded hyperlink (`name <url>`_). :guilabel: is not a reference
role, so the URL was rendered as literal text inside the badge with a
stray trailing underscore instead of a working link.

Split the badge from the link in all four versionchanged blocks: keep
:guilabel: for the menu labels and add a separate "the changelog entry"
hyperlink. Also fix the Backend Users note which wrongly read "moved
from Administration to Administration" (now "System to Administration")
and remove stray tab indentation.

Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>

@linawolf linawolf left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for fixing my mistake

@linawolf
linawolf merged commit 92bfd16 into TYPO3-Documentation:main Jul 25, 2026
5 checks passed
@typo3-docs-backport-bot

Copy link
Copy Markdown

linawolf pushed a commit that referenced this pull request Jul 25, 2026
…824) (#833)

The "Changed in version 14.0" notes tried to combine a :guilabel: role
with an embedded hyperlink (`name <url>`_). :guilabel: is not a reference
role, so the URL was rendered as literal text inside the badge with a
stray trailing underscore instead of a working link.

Split the badge from the link in all four versionchanged blocks: keep
:guilabel: for the menu labels and add a separate "the changelog entry"
hyperlink. Also fix the Backend Users note which wrongly read "moved
from Administration to Administration" (now "System to Administration")
and remove stray tab indentation.


(cherry picked from commit 92bfd16)

Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
Co-authored-by: Sebastian Mendel <github@sebastianmendel.de>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants