From 0882ac832b5217c481442fea5a75c2994e6ce370 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 17 Aug 2026 11:41:37 +0000 Subject: [PATCH] docs: give the last step of the chain its way back The bottom navigation covers the sidebar's 19 pages except the last one. Licenses is a step in the chain -- Writing an extension's next link points at it -- and it carries no navigation at all, so a reader who follows that link arrives with no way back and nothing saying they have reached the end. It could not have one. The template read one argument as the next step, so the first page of a chain could say it has nothing before it and the last page had no way to say it has nothing after it. The two ends were not symmetrical. Make them so: the first argument is the previous step and the second is the next, each side left empty where the chain ends. That drops the template's "second argument, or else the first" fallback and reads the two edges the same way. The two pages that used the one-argument form (index, Why wikitext) now write the empty first argument and render exactly as they did; Licenses gains the row it was missing. The order is still written twice, here and in MediaWiki:Sidebar, which is #455. What this fixes is the drift, not its cause: the chain now matches the sidebar entry for entry, in order. --- docs/Licenses.wikitext | 2 ++ docs/Template:prevnext.wikitext | 6 ++---- docs/Template:prevnext/doc.wikitext | 13 ++++++++----- docs/Why wikitext.wikitext | 2 +- docs/index.wikitext | 2 +- 5 files changed, 14 insertions(+), 11 deletions(-) diff --git a/docs/Licenses.wikitext b/docs/Licenses.wikitext index e5d90035a..55e2c1a36 100644 --- a/docs/Licenses.wikitext +++ b/docs/Licenses.wikitext @@ -23,3 +23,5 @@ __TOC__ The standalone binary is compiled with [https://frankenphp.dev/ FrankenPHP], which also links several Caddy modules; see the FrankenPHP project for their licenses. The Docker image keeps MediaWiki's own COPYING, and each component's full license text is available from its project. + +{{prevnext|Writing an extension|}} diff --git a/docs/Template:prevnext.wikitext b/docs/Template:prevnext.wikitext index 7ce4cd609..5f1495a3c 100644 --- a/docs/Template:prevnext.wikitext +++ b/docs/Template:prevnext.wikitext @@ -1,8 +1,6 @@
{{#if:{{{2|}}}| -
← [[Special:MyLanguage/{{{1|}}}|{{prevnext/label|{{{1|}}}}}]]
- }}
[[Special:MyLanguage/{{{2|{{{1|}}}}}}|{{prevnext/label|{{{2|{{{1|}}}}}}}}]] →
{{#if:{{{1|}}}|
← [[Special:MyLanguage/{{{1}}}|{{prevnext/label|{{{1}}}}}]]
}}{{#if:{{{2|}}}|
[[Special:MyLanguage/{{{2}}}|{{prevnext/label|{{{2}}}}}]] →
}}
{{prevnext/doc}} diff --git a/docs/Template:prevnext/doc.wikitext b/docs/Template:prevnext/doc.wikitext index 4cb07be65..dc5d12c14 100644 --- a/docs/Template:prevnext/doc.wikitext +++ b/docs/Template:prevnext/doc.wikitext @@ -2,11 +2,14 @@ Bottom-of-page navigation between the steps of the documentation, as a row of on == Usage == - {{prevnext|next step}} -{{prevnext|previous step|next step}} - -Each argument is a page name, not a link label: it is the link target, and the link text is the -target's own title. + {{prevnext|previous step|next step}} +{{prevnext||next step}} +{{prevnext|previous step|}} + +The first argument is always the step before this page and the second always the step after it, so +an end of the chain leaves its own side empty: the first page has nothing before it, the last has +nothing after it. Both are page names rather than link labels — the name is the link target, and +the link text is the target's own title. == Translated pages == diff --git a/docs/Why wikitext.wikitext b/docs/Why wikitext.wikitext index fa18af7ac..e779ce8f3 100644 --- a/docs/Why wikitext.wikitext +++ b/docs/Why wikitext.wikitext @@ -30,4 +30,4 @@ __TOC__ That last cost, running MediaWiki, is the one {{SITENAME}} removes: it renders your wikitext through MediaWiki once, at build time, and ships plain static HTML. You get templates, parser functions and the rest with nothing to run in production. Reach for {{SITENAME}} when that trade is worth it, typically when your content is already wikitext, or when templates and transclusion would save real work. -{{prevnext|Installation}} +{{prevnext||Installation}} diff --git a/docs/index.wikitext b/docs/index.wikitext index 138083de1..58d449e65 100644 --- a/docs/index.wikitext +++ b/docs/index.wikitext @@ -54,5 +54,5 @@ These need a live wiki, so they are not part of the static export: What replaces some of them is written down: the reader's own display choices are on a [[Special:MyLanguage/Skins#Settings|Settings page]] the build writes, and searching is [[Special:MyLanguage/Searching|done in the browser]]. -{{prevnext|Why wikitext}} +{{prevnext||Why wikitext}} {{DISPLAYTITLE:Wikven}}