Template talk:Annotated link/Archive 1

Bug with numbered SD
There is an issue with this template picking up short descriptions defined with a (correct if unnecessary) numbered parameter.
 * e.g. Outline of sports did have
 * The link  then displayed the "1="

Edited the SD template to not use 1= and both page and link to it display OK.
 * Edited this
 * Left this
 * There are 3,745 articles that have short description template and the 1 parameter. This search should find them:
 * That's too many to try to work-around manually, so we'll have to wait for the bug to get fixed. --RexxS (talk) 16:52, 23 November 2019 (UTC)
 * This appears to be a bug in Template parameter value. I have posted a bug report at the template's talk page. – Jonesey95 (talk) 16:38, 19 January 2020 (UTC)
 * I am not able to edit the Lua, so I created a template to test a workaround for the TPV bug. SDlink with tests in User:GhostInTheMachine/WIP. When TPV is fixed, SDlink can just become an alias for Annotated link. -- GhostInTheMachine (talk) 14:38, 21 January 2020 (UTC)
 * This appears to be a bug in Template parameter value. I have posted a bug report at the template's talk page. – Jonesey95 (talk) 16:38, 19 January 2020 (UTC)
 * I am not able to edit the Lua, so I created a template to test a workaround for the TPV bug. SDlink with tests in User:GhostInTheMachine/WIP. When TPV is fixed, SDlink can just become an alias for Annotated link. -- GhostInTheMachine (talk) 14:38, 21 January 2020 (UTC)

While the bug remains, use SDlink instead. This checks for and fixes the bad values being returned by Template parameter value &mdash; GhostInTheMachine talk to me 11:15, 5 June 2020 (UTC)
 * A trick such as this sometimes is necessary, if the shortdesc needs to contain an equals-sign. The alternate workaround of = gives correct results. DMacks (talk) 17:56, 10 March 2021 (UTC)

Anl and Anli
I am going to use Anl or Anli for abbreviation --BoldLuis (talk) 07:19, 17 April 2020 (UTC)


 * for what purpose? If it's WP:NOTBROKEN, it doesn't need fixing. Natureium (talk) 00:23, 22 April 2020 (UTC)
 * To long to write. They can be shortcuts, much used in Wikipedia. --BoldLuis (talk) 23:16, 16 May 2020 (UTC)

Deprecation in mainspace
For anyone watching here (but not there), please see Wikipedia talk:WikiProject Short descriptions where I'm suggesting deprecating this template in article space. –Deacon Vorbis (carbon &bull; videos) 20:15, 10 August 2020 (UTC)


 * Hello, Couldn't find your move via the link, but anyway I would like to move the same or a smiliar suggestion to deprecate this template in article space. This template is trash, and useless in most contexts, because one default annotation can not work well for several different contexts. Sauer202 (talk) 13:11, 3 March 2023 (UTC)
 * Well when you find it, you will see that the proposal failed for a number of reasons:
 * The template displays the wp:short description, which is what most visitors see when they visit. So if it is not good enough, then improve it because that is what visitors are seeing. (Many SDs have just been transcluded from wikidata and are either uselessly short or grotesquely long (and get truncated to 40 characters when returned by a search.)) If you consider 40 characters too low a limit, see Wikipedia talk:Short description/Archive 9
 * Many article titles are terse or use terms that mean little or nothing to those unfamiliar with the topic already. Exposing the SD gives visitors a clue as to why they might want to explore a [wp:See also]] topic. Serendipity is a key strength of Wikipedia: see also Guide to information sources
 * If the result is inappropriate in a specific context, then either (a) don't use the template or (b) better still, supplement it. Like this
 * (Elephants and mammoths)
 * which produces
 * (Elephants and mammoths)
 * and more, as noted elsewhere on this page. --𝕁𝕄𝔽 (talk) 17:25, 3 March 2023 (UTC)

This is highly offensive
I am among the most experienced Wikipedia editors and I find the existence of annotated links in Wikipedia highly offensive. Why is it a good idea to have links that cannot be edited? I don't know that I've ever seen and example that was not done in an illiterate manner in need of editing. Michael Hardy (talk) 22:41, 24 September 2020 (UTC)
 * , you can edit the annotations by editing the short descriptions. ~Kvng (talk) 18:30, 27 September 2020 (UTC)
 * Yes. And if a particular short desc. is good for the article but not good for a particular list entry (e.g. for contextual reasons), then don't use the template and do just do an entirely manual list entry.  — SMcCandlish ☏ ¢ 😼  00:22, 19 February 2021 (UTC)
 * I agree with Michael Hardy. The usefulness of this template is debatable. The effect of this is (intentionally or not) spewing of more or less irrelevant short descriptions in See also sections. Being able to customize any short description of links where they are used based on the context (if such a description is needed at all) is paramount. Sauer202 (talk) 14:06, 3 November 2021 (UTC)
 * And I agree with . I have done quite a few of these, in the many cases where the article names in the See Also were impenetrably cryptic, meaningful to those in the know but not otherwise. Pathfinding is one of the glories of Wikipedia and we should encourage serendipity. Yes, there have certainly been occasions where the short description has been unhelpful in context and I have had to replace it with something more meaningful. (This action is particularly likely to be needed when the link is to a section of a big article.) So if you find a case where you are not content with the SD displayed then (a) change the SD in the target or (b) write a relevant description. It would be better of course (IMO) if SDs weren't limited to a silly 40 characters but I've lost that argument. --John Maynard Friedman (talk) 20:23, 3 November 2021 (UTC)
 * As far as I am aware the short description is not limited to 40 characters, that is the recommended length for where 40 characters works acceptably. If it needs more to work, it can be made longer. &middot; &middot; &middot; Peter Southwood (talk): 09:17, 20 January 2022 (UTC)
 * Are you sure? That is not the message I took from Wikipedia talk:Short description/Archive 9 and some of my SDs have been 'improved' to fit. --John Maynard Friedman (talk) 19:36, 15 July 2022 (UTC)
 * , Sometimes a short description that is useful and accurate cannot be written in lass than 90 or 40 or some other arbitrary number of characters. Apps can be rewritten, we should not be dictated to by app writers for their convenience, and WMF do not have editorial authority over Wikipedia. Sometimes short descriptions can be improved by shortening, sometimes they are still acceptable, but not as good, sometimes a Procrustean approach just results in a useless, confusing, inaccurate or misleading short description. Our first duty is to our readers, we do not knowingly mislead or intentionally confuse them to suit an arbitrary limit. Demanding that we do so, to quote the section title, is highly offensive. &middot; &middot; &middot; Peter Southwood (talk): 03:59, 16 July 2022 (UTC)
 * Which was exactly my argument. See Wikipedia talk:Short description/Archive 9, where I list the many reasons why the current policy is fundamentally wrongheaded. --John Maynard Friedman (talk) 21:55, 16 July 2022 (UTC)

Documentation clarity
In "The handling of short descriptions is changing, so this template may not take default short descriptions from Wikidata", it's unclear what "may not" is intended to convey (i.e. "must not" vs. "might not"). — SMcCandlish ☏ ¢ 😼  00:20, 19 February 2021 (UTC)
 * "does not" was correct in this context. This template cares only about local descriptions and ignores Wikidata descriptions (and has since its creation). A edit in August 2020 to the doc page confused how this template fetches short description (always local) with how Wikipedia apps and other users fetch short descriptions (at the time local by default but Wikidata if no description is defined, currently also always local). I've reverted that edit. * Pppery * it has begun... 01:23, 19 February 2021 (UTC)

Annotated redirect?
Is there something equivalent for use with a redirect to a section? Praemonitus (talk) 02:22, 25 February 2021 (UTC)
 * This template already works with section redirects. Here's an example:


 * . Jarble (talk) 14:22, 26 May 2021 (UTC)
 * If the redirect has a short description it will be displayed. &middot; &middot; &middot; Peter Southwood (talk): 09:20, 20 January 2022 (UTC)
 * @Jarble I agree with Peter, if the linked article does not contain a short description, the one from the redirected article should be added.
 * Right now it does not work. Example:
 * --AdrianHObradors (talk) 19:38, 21 March 2022 (UTC)
 * The text of a short description is written on the assumption that it will be seen alongside the title of the article, not that it will be seen alongside the title of a redirect to the article. It might not make any sense in that second context. That's especially likely if the redirect is to a sub-section. So I think it's appropriate that this template does not extract a short description from a redirect's target, as it might not make sense.  Dr Greg  talk 20:20, 21 March 2022 (UTC)
 * And I disagree with Peter. There are many cases where the section targetted by the redirect is too small to have its own article but is reasonable to include in a broader topic article – but to use the ultra-terse SD for the overall article would mislead. So if you are applying ANLI and see no SD, then it either put the overall article in the ANLI (instead of the redirect) or add an SD to the redirect. There are still so many articles without SDs that you have to investigate anyway so it is not much extra hardship. I'm not sure if this amounts to the same point that DrGreg is making?--John Maynard Friedman (talk) 20:30, 21 March 2022 (UTC)
 * Yes, we are in agreement.  Dr Greg  talk 20:36, 21 March 2022 (UTC)
 * I see and I understand. We all on agreement then --AdrianHObradors (talk) 23:22, 21 March 2022 (UTC)


 * Just as an FYI after had to correct one of my edits, the SD goes after the #Redirect line. --John Maynard Friedman (talk) 13:59, 25 March 2022 (UTC)

Discussion relevant to effective use of this template
There is a discussion at Wikipedia talk:Short description to which editors interested in this template may wish to contribute. --John Maynard Friedman (talk) 12:13, 31 May 2021 (UTC)

Collision with markup
If the original article is in italic – a book title or non-English language, for example –  the template is putting the short description into italic too. Can this be corrected? --John Maynard Friedman (talk) 10:41, 1 August 2021 (UTC)
 * The 'piped link' option almost does it, see
 * but this example really should use lang-la but it doesn't work. --John Maynard Friedman (talk) 10:53, 1 August 2021 (UTC)
 * but this example really should use lang-la but it doesn't work. --John Maynard Friedman (talk) 10:53, 1 August 2021 (UTC)

Sorry, I don't understand. None of the above show an Annotated link with italics — GhostInTheMachine talk to me 19:02, 1 August 2021 (UTC)


 * No, they don't but arguably they should. What I was looking at is this form:  which has this result:
 * which is not correct, the short description should not be in italics. It should appear as
 * but of course it would be impossible to write anli to have any awareness of what markup surrounds it. No, my main concern is this: the ... markup for non-English text is deprecated by MOS:ACCESS, a lang template should be use to advice screen readers to use the appropriate 'voice' (makes more sense for e.g. French than Latin, obviously). So I'm looking for this template to be able to 'nest' another template, so as to cope with, which right now it can't:
 * nowiki wrapped after lua conversion  23:42, 2 February 2023 (UTC)
 * Any clearer? --John Maynard Friedman (talk) 19:55, 1 August 2021 (UTC)
 * I just had a thought that maybe piped argument might work but no:
 * Unless I've mistyped? --John Maynard Friedman (talk) 20:14, 1 August 2021 (UTC)
 * Do'oh, that's a redirect! :-( --John Maynard Friedman (talk) 20:16, 1 August 2021 (UTC)
 * That works! So just need another example in the template doc. --John Maynard Friedman (talk) 20:18, 1 August 2021 (UTC)
 * Unless I've mistyped? --John Maynard Friedman (talk) 20:14, 1 August 2021 (UTC)
 * Do'oh, that's a redirect! :-( --John Maynard Friedman (talk) 20:16, 1 August 2021 (UTC)
 * That works! So just need another example in the template doc. --John Maynard Friedman (talk) 20:18, 1 August 2021 (UTC)
 * That works! So just need another example in the template doc. --John Maynard Friedman (talk) 20:18, 1 August 2021 (UTC)


 * I would just keep it simple. This works... Renovatio imperii Romanorum – Intention to restore the Roman Empire — GhostInTheMachine talk to me 20:27, 1 August 2021 (UTC)
 * But unfortunately it uses the deprecated markup for foreign languages. I definitely consider it would be useful to add use of a nested Lang template to the examples. I'll try to find an example that isn't Latin. --John Maynard Friedman (talk) 22:23, 1 August 2021 (UTC)

I have added these three lines to the examples on the doc page: "Piped to use template:lang per MOS:FOREIGNITALIC

I assume that there are no objections. --John Maynard Friedman (talk) 23:01, 1 August 2021 (UTC)
 * At Village Pump (Technical), explains that "When used in mainspace, the lang template also spits out , which breaks the syntax of your intended wikilink. You can add   to avoid this." so I have revised the doc page accordingly. --John Maynard Friedman (talk) 12:38, 2 August 2021 (UTC)

Incompatible with {{=}}
Looks like this template is incompatible with =. I've written up the problem I observed at Template_talk:%3D. -- Mikeblas (talk) 23:39, 20 October 2021 (UTC)
 * This is a problem because it's also incompatible with the other way of putting equal signs into short descriptions, . The annotated link template incorrectly shows the "1=" part of short descriptions whose argument is formatted with 1 like that. —David Eppstein (talk) 03:22, 25 January 2022 (UTC)

Template-protected edit request on 5 March 2022
Add None (note the caps) to the list of short descriptions to show as blank, which I think is:  per User talk:Qwerfjkl. Qwerfjkl talk  18:19, 5 March 2022 (UTC)
 * I am opposed to this. I do not think it is broken. The editor assumes that "lowercase short description searches" need to be upper case, but the documentation was clear a while ago and was changed by . Leave it as is until consensus is reached that upper case should be used at all. Walter Görlitz (talk) 18:29, 5 March 2022 (UTC)
 * My change was not really without reason. WP:HOWTOSD requires that all short descriptions start with an upper-case character. "None" does not pose an exception to this as far as I can see. I quoted HOWTOSD when I made the edit; sorry if that was not clear enough. Furthermore, it would be consistent with many recent bot changes (like this one), and I agree with Qwerfjkl's notion that "none"-SDs should not interfere with (and much less be the target of) the work of editors explicitly seeaking out and correcting lower-case SDs.
 * Lastly, I think the most elegant fix for Qwerfjkl's request would be to make the #switch input case-insensitive by converting it to lower-case and thus not requring hardcoded upper-case variants of any keyword. IceWelder  &#91; &#9993; &#93; 19:09, 5 March 2022 (UTC)
 * Red information icon with gradient background.svg Not done for now: looks like a consensus needs to be established for this alteration. Please garner the needed consensus before using the template again.  P.I. Ellsworth &numsp;-  ed.  put'r there 18:48, 5 March 2022 (UTC)

Remember that "none" is not itself a Short description — "none" is a flag to the system meaning that there is no Short description. The question instead should only be: Do the various parts of "the system" handle "none" and "None" in the same way? — GhostInTheMachine talk to me 22:40, 5 March 2022 (UTC)