Conversation
The three version directives now take a :changelog: option that renders the link to the changelog entry in the version badge and resolves it through the changelog inventory. Until now the reference page showed only the hand-written permalink in the directive body, which is what the option replaces: it carries the same link text, taken from the entry's own title, and an entry that does not exist produces a build warning and the unresolved-reference marker rather than a link that leads nowhere. The section documents the three value forms (Core entry id, another manual's shortcode plus anchor, the local "#anchor") and the embedded "text <entry>" form for the case where the resolved title does not describe the change. The examples stay code-block only, no live directive: the option is in render-guides main but not in 0.41.0, which is what renders docs.typo3.org today. Assisted-by: claude-code:claude-opus-5 <info@sebastianmendel.de> Agent-Session: https://claude.ai/code/session_01NxSeVq1hDnGBCqKLGcjQ6m Agent-Host: 32116e Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
Three things from a re-read against the repo's own conventions: The heading underline was one character short of the title, which docutils would object to even though the render did not. The section used " -- " as a dash where the file, and the manual around it, use " - " (84 occurrences against 8). "The option takes three forms" read as if the embedded "text <entry>" form were a fourth. The three are ways to address the entry; the embedded form wraps any of them. Assisted-by: claude-code:claude-opus-5 <info@sebastianmendel.de> Agent-Session: https://claude.ai/code/session_01NxSeVq1hDnGBCqKLGcjQ6m Agent-Host: 32116e Signed-off-by: Sebastian Mendel <info@sebastianmendel.de>
|
Out of draft — the content is complete and One thing for whoever merges: this should not land before a render-guides release that carries the option. It is in A re-read against the repo's own conventions turned up three things, all fixed in
|
Documents the
:changelog:option that render-guides#1303 added toversionadded,versionchangedanddeprecated.Draft on purpose. The option is in render-guides
mainbut not in0.41.0, which is what renders docs.typo3.org today — I checked the tag rather than assuming. This should not merge before a release that carries it. Everything else is ready.The page currently shows only the hand-written permalink in the directive body, which is exactly what the option replaces, so the new section sits after the existing ones and says so. The link text the option produces is the entry's own title, i.e. what an author writes by hand today; the difference is that a non-existent entry now produces a build warning and the unresolved-reference marker instead of a permalink that leads nowhere.
Covered: the three value forms (Core entry id, another manual's interlink shortcode plus anchor, the local
#anchor), and the embeddedtext <entry>form for the case where the resolved title does not describe the change — an extension whose whole changelog page carries one label, for instance.Every example is a
code-block, none of them a live directive, so the page renders unchanged on the current release and nothing has to be revisited when the option ships.make test-docspasses with no warnings.Assisted by claude-code:claude-opus-5 — Session