Manual of Style

This page falls within the scope of the WikiProject Manual of Style, an initiative aimed at identifying and rectifying contradictions and redundancies, improving language usage, and harmonizing the pages that constitute the MoS guidelines.Manual of StyleWikipedia:WikiProject Manual of StyleTemplate:WikiProject Manual of StyleManual of Style articles The contentious topics procedure is applicable to this page. It is closely associated with the English Wikipedia Manual of Style and the article titles policy, both of which are considered contentious topics. Please carefully review the awareness criteria and exercise caution while making edits. See WP:PROPOSAL for Wikipedia's procedural policy concerning the creation of new policies and guidelines. See how to contribute to Wikipedia guidance to gain insights and receive recommendations on the creation and updating of policy and guideline pages.

The contentious topics procedure applies to this page. This page is related to the English Wikipedia Manual of Style and article titles policy, which has been designated as a contentious topic. Editors who repeatedly or seriously fail to adhere to the purpose of Wikipedia, any expected standards of behaviour, or any normal editorial process may be blocked or restricted by an administrator. Editors are advised to familiarise themselves with the contentious topics procedures before editing this page.

Archives

WP:CONTEXT archives Support and opposition Archive 1 Archive 2 Archive 3 Archive 4 – repeating links Archive 5 – links in quotations Archive 6 Archive 7 – final archive WP:BUILD archive Archive WP:MOSLINK archives Archive 1 Jul 2006 and earlier Archive 2 Archive 3 Sep 2006 – Jan 2009 Archive 4 Jan 2009 – May 2009 Archive 5 May 2009 – Jun 2009 Archive 6 Jul 2009 – Aug 2009 Archive 7 Sep 2009 – Feb 2010 Archive 8 Feb 2010 – Jun 2010 Archive 9 Apr 2010 – Sep 2010 Archive 10 Sep 2010 – Nov 2010 Archive 11 Nov 2010 – May 2011 Archive 12 May 2011 – Oct 2011 Archive 13 Oct 2011 – Apr 2012 Archive 14 May 2012 – Nov 2012 Archive 15 Nov 2012 – Sep 2013 Archive 16 Sep 2013 – Feb 2015 Archive 17 Jan 2015 – Jul 2015 Archive 18 Jun 2015 – Sep 2016 Archive 19 Sep 2016 – Nov 2019 Archive 20 Nov 2019 – Apr 2021 Archive 21 May 2021 –

When styling a label (in [[Main page|label]]), one can add the style code inside or outside the brackets:

inside

[[Main page|''ABC'']] → ABC

[[Main page|<span style="background: pink">DEF</span>]] → DEF

outside

'''[[Main page|GHK]]''' → GHK

<span style="background: pink">[[Main page|LMN]]</span> → LMN

Both options work as expecteed, and no WP:LINTER errors reported. Special:ExpandTemplates does not alter them. My question is: is there a preferred convention in this? DePiep (talk) 14:33, 26 February 2023 (UTC)Reply[reply]

In practice, if we're going to have a preferred convention, it should be whatever the visual editor does, because editors using it don't get a choice.

I will point out, as @Jdforrester once pointed out to me, that when you want to write something with mixed formatting, such as [[Main page|OPQ<sub>2</sub>]] or [[Main page|RS''T'']], the formatting must be inside the label. Therefore if one wanted to have a preference, it might be a good idea to prefer the version that always works, rather than preferring the version that only works if the link label gets the same formatting throughout.

This, naturally, is the opposite of what many editors find aesthetically pleasing. I recommend not establishing a preferred convention. WhatamIdoing (talk) 21:54, 7 March 2023 (UTC)Reply[reply]

Agreed with WhatamIdoing, except I think it would probably be good to recommend (or at least consistently illustrate) the "inside" style, for the [[Main page|RS''T'']] reason given above, but only if it's what VE does. If VE puts the markup outside by default, then all bets are off and we just have to throw up our hands.  — SMcCandlish ☏ ¢ 😼  02:33, 14 June 2023 (UTC)Reply[reply]

The visual editor always puts bold/italics on the inside of the brackets if a piped link is involved: [[This|''That'']] and on the outside if for a simple link: ''[[This]]''. WhatamIdoing (talk) 02:45, 14 June 2023 (UTC)Reply[reply]

The link in the edit summary for this edit should have been to wp:FIXTHEPROBLEM. Sorry about that. - Butwhatdoiknow (talk) 20:07, 25 June 2023 (UTC)Reply[reply]

Hi. An editor keeps on doing this, across the project. I've discussed this with him, and pointed him to wp:overlink. To no avail. Suggestions? 2603:7000:2101:AA00:ACA0:80D5:F00F:2AA1 (talk) 03:36, 18 July 2023 (UTC)Reply[reply]

Definitely overlinking for anyone, let alone readers who can speak English, whether natives or non-natives. Tony (talk) 04:32, 18 July 2023 (UTC)Reply[reply]

Generally, follow Wikipedia:Dispute resolution. One option is to provide some background here about the situation (e.g. a few relevant examples), and invite the user here to discuss further.—Bagumba (talk) 05:25, 18 July 2023 (UTC)Reply[reply]

Thanks. I'm inviting User:ElKevbo here, as follow-up to our dead-end discussion on the editor's talk page at [1] hoping to avoid a long drawn-out colloquy that wastes peoples' time. See also [2], (replacing one bad format w/another bad format --2603:7000:2101:AA00:ACA0:80D5:F00F:2AA1 (talk) 06:11, 18 July 2023 (UTC)Reply[reply]

I disagree with the application of this principle in this specific instance. It's more helpful for readers for us to be consistent in linking the location of a subject in the infobox and lede sentence. ElKevbo (talk) 11:34, 18 July 2023 (UTC)Reply[reply]

Sorry to disappoint, but I don't think anyone clicks on a link to such a commonly known location. The long-established practice is to minimise linking—for readability and, importantly, to avoid diluting the linking system. Editors normally use their skills to funnel readers to the most useful links only. One final point: no one is stopped from typing NYC into the search box. Tony (talk) 13:27, 18 July 2023 (UTC)Reply[reply]

If you choose to edit Wikipedia, you're choosing to follow Wikipedia's style. Linking New York City is specifically given in MOS:OL as a example of something not to do. There is no exception for the lead sentence. Dan Bloch (talk) 14:33, 19 July 2023 (UTC)Reply[reply]

For the lead sentence, MOS:CONTEXTLINK may apply, and if so, it would override our normal overlinking rules. It'd be helpful to see the specific context of this dispute. ((u|Sdkb)) ^talk 14:37, 19 July 2023 (UTC)Reply[reply]

The locus of dispute may be Columbia Business School, an academic entity located in New York City. This is the exact type of article where you would want to link New York City, at the very least in the infobox. It's completely pertinent to the subject matter.

MOS:OL states it is usually not linked, but certainly genuine New York City topics can link New York City. There's no policy against ever linking it. Folly Mox (talk) 23:42, 20 July 2023 (UTC)Reply[reply]

"certainly?" Not the way I see it. That's quite a stretch. That's also perhaps a large number of topics - any person born there, etc. We all "certainly" are likely to already know what NYC is. 2603:7000:2101:AA00:140E:8D52:238D:9E20 (talk) 04:50, 9 August 2023 (UTC)Reply[reply]

Apologies for the unclear wording. I should have written genuine New York City topics can certainly link New York City. As to what constitutes a "genuine New York City topic", I agree that this does not include people born there and a vast array of adjunct topics, but I think something like an academic institution, a municipal election, a neighbourhood, a museum, a transit system, and so on— these should be allowed to link the city in which they're situated, regardless of which city it is. At least in the infobox. Probably not the prose. The fact that people know what New York City is doesn't mean they'll never have reason to navigate to its article, especially if they've just been reading one about a related topic. Folly Mox (talk) 05:39, 9 August 2023 (UTC)Reply[reply]

The simple solution would be to never link New York City. We could probably have the same rule for Paris, Rome and London (except where one might reasonably think of London, Ontario), etc. Almost no one clicks on such links and they are easy enough to type in the search box. Edwardx (talk) 10:34, 9 August 2023 (UTC)Reply[reply]

MOS:OVERLINK reads:

The names of subjects with which most readers will be at least somewhat familiar. This generally includes major examples of...locations (e.g., New Delhi; New York City, or just New York if the city context is already clear; London, if the context rules out London, Ontario; Southeast Asia)

—Bagumba (talk) 10:59, 9 August 2023 (UTC)Reply[reply]

• Entirely with Edward; and entirely not with Folly Mox. I'm pretty confident that not more than one in a million readers is likely want to divert from the article they've arrived at to read the article on NYC. There seems to be a fallacy about linking—that if an item is not linked, its article is somehow inaccessible. No: that's why we have a search box. Every redundant link has costs. Tony (talk) 12:41, 9 August 2023 (UTC)Reply[reply]

  @Tony1 What are those costs in your view? ((u|Sdkb)) ^talk 13:34, 9 August 2023 (UTC)Reply[reply]

  This was all covered in the huge community-wide RfC in 2009. I'm surprised to be asked this in 2023 (unless you come from another-language WP where linking is completely undisciplined). (1) It dilutes the system, whereas we editors know the topic and can be trusted to link sparingly only to items that are genuinely likely to be followed by at least a small number of readers. Undisciplined linking means that we can't communicate this to readers, who are more likely to switch off. (2) A patchy "sea of blue" doesn't make it easier to read, (3) Synoptically it looks messy and unprofessional. Tony (talk) 00:08, 10 August 2023 (UTC)Reply[reply]

The assertion that some articles should never be linked to is ridiculous. Articles are not meant to be orphans with no incoming links and readers are not supposed to navigate Wikipedia solely by searching for articles. ElKevbo (talk) 12:50, 9 August 2023 (UTC)Reply[reply]

Unless a term is particularly relevant to the context in the article, the following are usually not linked. I guess it's my perspective that geographic situation is often relevant to context for certain types of topics. Academic institutions are arguably pretty low on the list, unless the institution has major influence on the local culture, which I doubt Columbia University is an example of. But to argue that certain well known major cities are never particularly relevant to context seems like an extreme position.

Trying to understand the perspective of the people who hold that position (fairly well reflected in the guidance itself), it seems to me – and apologies in advance if this feels like a mischaracterisation – the mindset is that readers will only ever click on an article if they are totally unfamiliar with the topic, and Tony1 above in particular expresses this as diverting from the current article, as if people don't have access to multiple tabs, and can open an article in the background to read later or forget about for months until their browser crashes and then they reopen it like "why did I have this article open?".

My personal use case, which I suspect I share with a number of other ADHD people, is not "wait, what's a “New York City”? let me read that article instead", but "hmm, tell me more" (now closer to "I wonder what our coverage of Well-known Topic is like" and "I wonder what our sourcing at Well-known Topic is like", but these are definitely editor concerns rather than reading habits). Folly Mox (talk) 13:31, 9 August 2023 (UTC), with 97 tabs open in the background.Reply[reply]

New York City will never become an orphan - removing such links is like a game of Whac-A-Mole. One could make a case for linking to New York City in articles on geographical subdivisions such as Brooklyn and Manhattan, but that is about it. We have 188,514 wikilinks to New York City. Surely that is far too many. Edwardx (talk) 13:39, 9 August 2023 (UTC)Reply[reply]

Agree 💯, but claim that some subset of those incoming links is likely appropriate. Folly Mox (talk) 16:53, 9 August 2023 (UTC)Reply[reply]

Some folks here are citing MOS:OVERLINK, but for the lead sentence, the pertinent guideline section is not that but MOS:CONTEXTLINK. And it's unambiguous on this point:

The first sentence should provide links to the broader or more elementary topics that are important to the article's topic or place it into the context where it is notable.

For example, an article about a building or location should include a link to the broader geographical area of which it is a part.

If folks want to challenge the guideline, feel free to discuss, but there should be no ambiguity about how we currently define best practice for this situation.

The only other thing I'd note is that if something is located entirely within one borough, it might be possible to sidestep the issue by listing the borough and linking to that instead of the city. ((u|Sdkb)) ^talk 17:57, 9 August 2023 (UTC)Reply[reply]

Both policies are pertinent, and they conflict to some extent, as is sometimes inevitably the case with the MOS. I edit far more London articles, and in the lead would normally link to the district and not the city itself, eg Hampstead, London. Edwardx (talk) 00:02, 10 August 2023 (UTC)Reply[reply]

Edward, that's good linking practice. Tony (talk) 00:03, 10 August 2023 (UTC)Reply[reply]

Geez I hadn't really considered that, and I both fully agree with it and feel even more dumb than usual for my oversight. Folly Mox (talk) 01:03, 10 August 2023 (UTC)Reply[reply]

https://en.wikipedia.org/w/index.php?title=R_Praggnanandhaa&diff=1171848036&oldid=1171845836

Is Rejoy2003's interpretation of MOS:GEOLINK correct? Khiikiat (talk) 15:03, 23 August 2023 (UTC)Reply[reply]

GEOLINK says not to link larger units, whether they are countries, provinces, states, etc. And Buffalo, New York is a single link, not consecutive links. —Bagumba (talk) 15:59, 23 August 2023 (UTC)Reply[reply]

WP:GEOLINK specifies larger unit, not unit(s). This pertains to the country, as demonstrated by the accompanying examples. In fact, this guideline only discusses the case where two geographical units are separated by a comma, with the second unit being specifically a country.

Regarding the specific case at hand, Tamil Nadu is a location that might not be familiar to the majority of readers. This validates the purpose of a link, as not doing so could potentially force readers to manually search or to open Chennai article and then open Tamil Nadu from there.

Since there's confusion and changes like this affect a vast majority of articles, I strongly recommend initiating an RFC. This process will facilitate a thorough discussion on whether "larger unit" should be revised to "country" or if it should encompass all larger units following a comma. In either scenario, seeking consensus through an RFC will establish a definitive guideline to address any future disputes.--The Doom Patrol (talk) 10:56, 28 August 2023 (UTC)Reply[reply]

We have already had an RfC on GEOLINK, which did not pertain solely to the country but also to lower-level entities (thus the example of Buffalo). Nikkimaria (talk) 23:50, 28 August 2023 (UTC)Reply[reply]

The first thing I notice is that the guidance says generally do not link (emphasis added), while the hidden comment removed in the diff above shouts DO NOT LINK in all caps like it's some kind of core content prohibition. There will be cases where a link is warranted.

As a practical matter, a fairly large number of users run the popular script User:Ohconfucius/script/Common Terms to delink common terms, so anything listed in the regexes at User:Ohconfucius/script/Common Terms.js will continue to be delinked en masse forever irrespective of any consensus reached here. This includes most primary subdivisions of many countries, including Tamil Nadu. Folly Mox (talk) 13:14, 28 August 2023 (UTC)Reply[reply]

When linking to sections, but not piping the link(such as in see also sections or disambiguation pages), is Article § section preferred over Article#section? I ask this because there was a concern raised at my talk page. Ca ^{talk to me!} 07:20, 16 September 2023 (UTC)Reply[reply]

Per MOS:SECTLINK and by example in the MOS itself, the § format is preferred. Whether or not you use the ((Section link)) template is different, although I don't see why you wouldn't. But I do agree that the guidance could be more direct. Orange Suede Sofa (talk) 07:28, 16 September 2023 (UTC)Reply[reply]

Pinging @Valjean Ca ^{talk to me!} 07:33, 16 September 2023 (UTC)Reply[reply]

Gioachino Rossini
Rossini in 1865, photo by Étienne Carjat
Born	(1792-02-29)29 February 1792 Pesaro, Italy
Died	13 November 1868(1868-11-13) (aged 76) Passy, Paris, France
Works	List of compositions

Two days ago, I opened a discussion at Talk:Gioachino Rossini to debate the addition of an infobox. For those who may be unaware, WikiProject Composers has an age-old policy guideline that disallows infoboxes in composer biographies, but this has been changed in recent years. This question isn't about that; rather, this is about the inclusion of something within a possible Rossini infobox.

To the right is the infobox I proposed, similar in style to Mozart, Beethoven, Chopin, Shostakovich, Prokofiev, etc. The inclusion of the article link to "List of compositions" in the works parameter has been the subject of debate. @Gerda Arendt and I state that the inclusion is justified because the link shows that Rossini was notable for composing and this is the standard on many other composer articles. @Nikkimaria countered that MOS:FORCELINK, which is part of Wikipedia:Manual of Style/Linking, disallows these kinds of links per the words, "The text needs to make sense to readers who cannot follow links. Users may print articles or read offline, and Wikipedia content may be encountered in republished form, often without links." I argued that the very bullet point Nikki quoted also says, "Use a link when appropriate, but as far as possible do not force a reader to use that link to understand the sentence." (emphasis added) Infoboxes are certainly not sentences, but Nikki found this to still apply, since it "mak[es] it so readers could only understand the oeuvre of the article subject by following a link, which is what NOFORCELINK exists to combat".

So, now I am here. I understand the point Nikki is making and understand how it may apply to the infobox, but I want the input of people who frequent the MoS and deduce the sometime vague phrasing. Is the inclusion of the "List of compositions" link under the works parameter a violation of the MoS? MyCatIsAChonk (talk) (not me) (also not me) (still no) 00:18, 4 October 2023 (UTC)Reply[reply]

As noted, MOS:INFOBOXPURPOSE is also relevant: "key facts at a glance", without having to chase links. Nikkimaria (talk) 00:20, 4 October 2023 (UTC)Reply[reply]

I've always found links to lists in infoboxes slightly odd, but they're highly relevant to the subject, and reader data shows that having them is important for helping readers discover the list. The only alternative seems to be leaving them out, which doesn't feel optimal. And the NOFORCELINK argument seems rather weak per MyCat's argument. ((u|Sdkb)) ^talk 00:58, 4 October 2023 (UTC)Reply[reply]

Also, this is a very widely adopted practice, used in FAs like Taylor Swift, so disallowing it would be a significant change. ((u|Sdkb)) ^talk 01:02, 4 October 2023 (UTC)Reply[reply]

I'm not sure what conclusion you're trying to draw from the meta research, but it does not show that readers either want to read those links, or that they find them useful. All eyetracking software does is see what parts of a screen attract the eyes. It's why anything in a box, or an image or bullet points will always draw the eye away from the text. That's different from the claim that readers want those links or actively seek them out. - SchroCat (talk) 09:53, 9 November 2023 (UTC)Reply[reply]

I believe what @Sdkb is getting at is that these links are just helpful. Regardless of reader data, people on devices will be able to easily navigate to other information through this box, and those not on devices will see "Thirty-nine operas" (see the second box proposal below). If these links are in violation of the MoS, why was it not caught at the Taylor Swift FAC? Because these links are simply helpful, and that's what editors truly care about. MyCatIsAChonk (talk) (not me) (also not me) (still no) 12:00, 9 November 2023 (UTC)Reply[reply]

The rest of the sentence in question seems to have been conveniently forgotten: "The text needs to make sense to readers who cannot follow links. Users may print articles or read offline, and Wikipedia content may be encountered in republished form, often without links." Given the output without links is "Works List of compositions", I fail to see how that non-linking text fulfils the policy requirements. In other words, while some people will be able to use the link, a large number will not, and our policy is that it should not be allowed. Feel free to remove the non-compliant entry in Taylor Swift if you prefer, but WP:LOCALCONSENSUS cannot overrule policy. - SchroCat (talk) 12:05, 9 November 2023 (UTC)Reply[reply]

That is solvable if we created a new parameter for a list page link (|list_of_works=)) and set the data row class in the infobox code to class="noprint". From what I understand from the noprint class it will remove that piece of text from pinted versions. Template:Infobox television episode does it with its episode list link. Gonnym (talk) 12:09, 9 November 2023 (UTC)Reply[reply]

Not for re-users of our freely available product it doesn't, or for those that read offline. - SchroCat (talk) 12:39, 9 November 2023 (UTC)Reply[reply]

Can't win them all. I prefer a better user-experience for 80% of users, than a sub-par for 100%. Gonnym (talk) 12:47, 9 November 2023 (UTC)Reply[reply]

But that doesn't stop the use being against established policy. If that is to change, that needs to be re-written after an RFC that specifically allows us to ignore a proportion of our readers. - SchroCat (talk) 12:49, 9 November 2023 (UTC)Reply[reply]

When you say "policy", do you mean this piece of text: Use a link when appropriate, but as far as possible do not force a reader to use that link to understand the sentence. The text needs to make sense to readers who cannot follow links. Users may print articles or read offline, and Wikipedia content may be encountered in republished form, often without links.? If so, that is a guideline, not a policy. Also, it says as far as possible, well, having the noprint class fixes most of the usage and that checks the "as far as possible" requirement. Unless you are referring to a different policy I missed in this discussion, there is no need for a RfC, unless you wish to start one. Gonnym (talk) 12:54, 9 November 2023 (UTC)Reply[reply]

If you are happy that to ignore a proportion of readers and not serve them, then there is little I can say - or would even want to say. I would say it runs counter to everything we do, and as such an RFC would be the only way to get the community's input on the proportion of readers we should serve against those we should ignore. It is a position that is even less constructive than endless pushing for IBs into a range of articles, but whatever floats people's boats, I guess. - SchroCat (talk) 13:02, 9 November 2023 (UTC)Reply[reply]

How big of a userbase (those that don't read online or printed versions) are we ignoring? Do you have a percentage? I highly doubt that it is anywhere near what you inferring it to be. Gonnym (talk) 13:09, 9 November 2023 (UTC)Reply[reply]

I agree with Nikkimaria that this is not a helpful thing to put into this infobox. The first sentence of the lead of Gioachino Rossini says in part that he gained fame for his 39 operas, so we already know he's notable for composing. And of course the link to List of compositions by Gioachino Rossini is already in the article, under "Music" in a ((see also)), so it's not something you'd have to hunt to find.

From a practicality standpoint, were this link to be added to the infobox, it would be a short time before uninvolved editors found it lacking in that it communicates no facts, and start adding examples they felt to be most notable while keeping the list as a link under the last example. This would evolve into an unpleasant argument between editors as to which examples to include, which compositions "most notable". Struck speculation not reflected in past events 15:28, 4 October 2023 (UTC)

As to whether it's an MOS violation, I'd say that it doesn't comply with WP:INFOBOXPURPOSE as noted. It's not a quick essential fact about the subject that Wikipedia has a list article about his compositions. Folly Mox (talk) 00:58, 4 October 2023 (UTC)Reply[reply]

I should clarify that links to lists in infoboxes are not bad in all cases. Especially regarding my second paragraph, if there were a generally agreed upon subset of compositions that everyone knows are the most notable, it's not a problem. You have the best examples with the link to all at the bottom of that field. It is very helpful for discoverability as Skdb notes above in the edit mine conflicted with.

The problem for this case is that unless such an agreed upon subset of most notable compositions exists, you're going to end up back at none at all. Folly Mox (talk) 01:03, 4 October 2023 (UTC)Reply[reply]

Quick thought: would something like Operas, cantatas and much else be sufficiently factual, or fall foul of WP:EASTEREGG or other good practice? NebY (talk) 12:57, 4 October 2023 (UTC)Reply[reply]

I'm not really an MOS regular like User:MyCatIsAChonk is looking for: I just watchlist a few pages. Having had a look into how the infoboxes in liberal arts biographies have traditionally implemented this unproblematically, and given the usefulness argument presented above by User:Skdb, I feel like although just a bare link to another article doesn't fully comply with MOS:INFOBOXPURPOSE, it does serve the reader.

Having said that, for this case there is an additional issue in that List of operas by Gioachino Rossini has already been split from List of compositions by Gioachino Rossini, which links it as a "see also" in its first lvl2 subheading. If the lead sentence of the article says Rossini "gained fame for his 39 operas", that's what I'd expect to be linked in the infobox if a link is included in this parameter. If he's notable for the rest of his compositions similarly to his notability from operas, we could link both the articles and update the lead sentence to reflect that. Folly Mox (talk) 15:26, 4 October 2023 (UTC)Reply[reply]

Gioachino Rossini
Rossini in 1865, photo by Étienne Carjat
Born	(1792-02-29)29 February 1792 Pesaro, Italy
Died	13 November 1868(1868-11-13) (aged 76) Passy, Paris, France
Works	Thirty-nine operas Other compositions

@Folly Mox, I was completely unaware of the list of operas, how silly of me. To the right is proposal two, with a similar format to Taylor Swift- thoughts? MyCatIsAChonk (talk) (not me) (also not me) (still no) 20:53, 4 October 2023 (UTC)Reply[reply]

Maybe it should be "Operas" and "Other compositions", however? After all, operas are compositions too. Gawaon (talk) 21:45, 4 October 2023 (UTC)Reply[reply]

That makes more sense, thank you- updated accordingly. MyCatIsAChonk (talk) (not me) (also not me) (still no) 21:49, 4 October 2023 (UTC)Reply[reply]

Perhaps Thirty-nine operas or some such, on the WP:EASTEREGG principle that Operas would normally be expected to link to Operas, and to make the magnitude clear even without clicking on the link? NebY (talk) 08:06, 5 October 2023 (UTC)Reply[reply]

Well, in the aforementioned Taylor Swift infobox, it doesn't say "10 albums" or "59 singles"; it just says albums, singles, etc. That being said, the general reader would likely be much more familiar with modern music practices than opera, but do you think the familiarity plays a part? MyCatIsAChonk (talk) (not me) (also not me) (still no) 10:56, 5 October 2023 (UTC)Reply[reply]

One trade-off there is that, if we list the number, we then have to update it whenever the number changes. That's obviously less of a concern with a BDP than with someone mid-career. ((u|Sdkb)) ^talk 14:23, 5 October 2023 (UTC)Reply[reply]

Very good point, I agree- updated MyCatIsAChonk (talk) (not me) (also not me) (still no) 15:25, 5 October 2023 (UTC)Reply[reply]

The idea of naming the link "Thirty-nine operas" elegantly realizes MOS:INFOBOXPURPOSE's principle "key facts at a glance". It may be worth inclusion here, or at least at Wikipedia:Manual_of_Style/Infoboxes, so I suggested it there. ◅ Sebastian Helm 🗨 11:52, 23 October 2023 (UTC)Reply[reply]

Many thanks- I'll likely open an RfC at Rossini once the discussion over there is concluded. MyCatIsAChonk (talk) (not me) (also not me) (still no) 15:29, 23 October 2023 (UTC)Reply[reply]

Agreement and “change spree ”

The following discussion is closed. Please do not modify it. Subsequent comments should be made on the appropriate discussion page. No further edits should be made to this discussion.

---

The MOS currently advises If quoting hypertext, add an editorial note, [link in original] or [link added], as appropriate. In practice, though, I almost never see this, as these parentheticals would generally cost more in terms of interrupting the reading flow than they'd provide in clarity benefit. Could we reconsider this advice? Perhaps not note "link added" and only note "link in original" when it's deemed significant to the quote's point? Or perhaps consider advising a footnote or some other less-intrusive means of providing the disclaimer? ((u|Sdkb)) ^talk 07:50, 4 October 2023 (UTC)Reply[reply]

Yeah, just suggesting a "link in original" (if helpful) seems reasonable and certainly corresponds to the status quo. Like you say, everybody quotes from hypertext (that is, other websites) all the time, adds wikilinks as appropriate, and never marks them. Gawaon (talk) 10:33, 4 October 2023 (UTC)Reply[reply]

I took a stab at changing the advice, and converted it to a footnote since it applies to a very niche situation.

Now excuse me while I go on an AWB spree to mass-change the, uh, one article that abided by the old rule. ((u|Sdkb)) ^talk 22:06, 4 October 2023 (UTC)Reply[reply]

Thanks! Since it seems you were busy elsewhere, I completed the change spree for you . Gawaon (talk) 06:39, 5 October 2023 (UTC)Reply[reply]

The discussion above is closed. Please do not modify it. Subsequent comments should be made on the appropriate discussion page. No further edits should be made to this discussion.

What generally should not be linked is written from an absolute point of view: It stipulates a selection of links that is the same for every article, by using only such criteria as “everyday words” and “countries”. But does that really make sense for an article about a specialized topic? Example: The article Z-transform currently links such articles as multiplication, real number and numerator. What is the use case for these? In other words: Do we really think such a specialized article will be read by people who will need to look these up? ◅ Sebastian Helm 🗨 10:32, 23 October 2023 (UTC)Reply[reply]

Do we really think such a specialized article will be read by people who will need to look these up? Yes. Wikipedia is for everyone. WP:TECHNICAL provides a more comprehensive guideline on highly technical subjects. 2A02:A44A:5C96:1:ECBF:6E49:898B:49CB (talk) 22:35, 23 October 2023 (UTC)Reply[reply]

Interesting interpretation of “Wikipedia is for everyone”. Yes, Wikipedia is open for people who have never heard of such things as multiplication. But that doesn't mean that we have to dumb down each and every article to that level, thereby making it harder for the expected audience. If anyone who doesn't know what “multiplication” means wants to read the article Z-transform, they is free to do so, and they is free to enter “multiplication” in the search box. In conclusion: Wikipedia already is for everyone, no need to double these efforts in each and every article. ◅ Sebastian Helm 🗨 09:46, 9 November 2023 (UTC)Reply[reply]

It is a case by case basis following the consensus policy. But I would think that "multiplication" does not need to be linked in every math article and I wouldn't link it to Z-transform, my first impression without delving deeper in the context. Regards, Thinker78 (talk) 20:56, 25 October 2023 (UTC)Reply[reply]

If we want an absolute statement here, how about giving a proportion that works well in our experience, such as: “If an article contains more than one link for every 400 bytes (as can be seen from its latest history entry), it may be overlinked, if less than one for every 1200 bytes, it may be underlinked”? ◅ Sebastian Helm 🗨 10:54, 23 October 2023 (UTC)Reply[reply]

Just a heads up that there is an algorithm that already has ideas about this, and is anticipated to be informing placement of wikilinks around the beginning of next year. Folly Mox (talk) 12:25, 23 October 2023 (UTC)Reply[reply]

Thanks. So it looks like we can put this question on the back burner for now. Please ping me when there is anything new. ◅ Sebastian Helm 🗨 09:46, 9 November 2023 (UTC)Reply[reply]

Greetings and felicitations. This topic isn't mentioned in the project page, and a brief search of this talk page's archives (not including the those in the sidebar) did not turn up anything relevant. In my opinion it is best to start with Wikimedia project links, followed by official links (edit: and then everything else), but is there any consensus on this? —DocWatson42 (talk) 06:27, 6 November 2023 (UTC)Reply[reply]

WP:ELORDER Moxy- 13:19, 6 November 2023 (UTC)Reply[reply]

WP:ELORDER covers where in the article the external links section goes. The only thing it has to say about the order of the links within it is that an link to an official site should go first. However, the next section, WP:ELTEMP, says to put templates containing external links (such as for Wikipedia projects) after the external links section (or, equivalently, at the bottom of it). Largoplazo (talk) 16:48, 6 November 2023 (UTC)Reply[reply]

Thank you both—that was what I was (fruitlessly) looking for, in the wrong places. ^_^ —DocWatson42 (talk) 04:52, 12 November 2023 (UTC)Reply[reply]

When adding the first citation of Mohammed Dajani Daoudi^[1], first using Virtual Editor and then source editor, I tried to make a direct link from Fathom Journal/fathomjournal to the Fathom journal section of Britain Israel Communications and Research Centre based on the examples of Template:Section link but either the article and section titles were italicised or error notices appeared. In the end I left it as a link to Fathom Journal which redirects to the Centre. Should it be possible to make a direct link from the citation to the section? Mcljlm (talk) 22:17, 14 November 2023 (UTC)Reply[reply]

I would say that you shouldn't link to the section, regardless. If Fathom Journal wikilinks should be targeted at Britain Israel Communications and Research Centre#Fathom journal, then the redirect should instead be updated to go directly to that section. (Redirects can totally do that.) That way, the decision about the correct destination for links to Fathom Journal is made centrally and by consensus, rather than each individual citation author making their own call. FeRDNYC (talk) 15:55, 21 December 2023 (UTC)Reply[reply]

(Also, FWIW in the case of Fathom Journal in particular, I think linking to the overall Britain Israel Communications and Research Centre article makes the most sense. There's almost nothing IN the section on Fathom; certainly, nothing that helps to inform readers about the cited work. So, the fact that Fathom is published by the BICRC is the more relevant info.

If the Fathom journal section were fleshed out with more information about the publication, that might change things. But right now it's just not a good direct-link target.) FeRDNYC (talk) 17:13, 21 December 2023 (UTC)Reply[reply]

The redirect MOS: LINK has been listed at redirects for discussion to determine whether its use and function meets the redirect guidelines. Readers of this page are welcome to comment on this redirect at Wikipedia:Redirects for discussion/Log/2023 December 5 § MOS: LINK until a consensus is reached. Utopes _{(talk / cont)} 04:03, 5 December 2023 (UTC)Reply[reply]

The redirect MOS: NOPIPE has been listed at redirects for discussion to determine whether its use and function meets the redirect guidelines. Readers of this page are welcome to comment on this redirect at Wikipedia:Redirects for discussion/Log/2023 December 5 § MOS: NOPIPE until a consensus is reached. Utopes _{(talk / cont)} 04:04, 5 December 2023 (UTC)Reply[reply]

The redirect MOS: OL has been listed at redirects for discussion to determine whether its use and function meets the redirect guidelines. Readers of this page are welcome to comment on this redirect at Wikipedia:Redirects for discussion/Log/2023 December 5 § MOS: OL until a consensus is reached. Utopes _{(talk / cont)} 04:04, 5 December 2023 (UTC)Reply[reply]

After the Wikipedia talk:Manual of Style/Linking/Archive_21#DL,_sections,_and_mobile_readers RFC, which demonstrated overwhelming consensus in support of relaxing the "once per article" rule for links to "once per section", RFC closer Mike Christie made a perfectly reasonable edit-of-least-disruption to the page, altering the introduction of MOS:DUPLINK like so:

Generally, a link should appear only once in an article, but it may be repeated if helpful for readers, such as in infoboxes, tables, image captions, footnotes, hatnotes, and at the first occurrence after the leadin a section.

Reasonable, sure. Least-disruptive, sure. But... accurate?

Now more than ever, the actual rules we've settled on contradict the statement, "Generally, a link should appear only once in an article". Whether or not that was even accurate before (given the long list of exceptions), in the wake of the RFC it certainly doesn't seem right anymore.

Generally, the community expressed broad consensus for generally eliminating that restriction, and links are now permitted once per section, generally. So, why are we still opening with a statement of the policy as it (generally) maybe used to be?

IMHO we should bite the bullet, embrace the change, and open with something like:

Generally, a term should be linked at most once in each section of an article, the first time it's mentioned in that section. Subsequent repetitions should not be linked. (Note that this is a maximum link frequency; if it's relevant to link a term in one section, but not relevant in another, the term is not required to be linked in both. Common sense should always prevail.)

Outside of the body text, additional mentions of the same term may be linked if helpful for readers, such as in infoboxes, tables, image captions, footnotes, and hatnotes.

FeRDNYC (talk) 15:47, 21 December 2023 (UTC)Reply[reply]

That sounds reasonable to me, and an accurate summary of what we really do, though it could be considerably compressed:

Link a term at most once per section, at first occurrence. Common sense applies; do not re-link in other sections if not contextually important there. Other mentions may be linked if helpful, such as in infoboxes, tables, image captions, footnotes, and hatnotes.

That appears to get the same messages across in much less wording.  — SMcCandlish ☏ ¢ 😼  01:52, 18 January 2024 (UTC)Reply[reply]

Sounds good to me. Gawaon (talk) 14:25, 24 January 2024 (UTC)Reply[reply]

I've proposed updating Template:Infobox company's documentation to avoid a potential MOS:EGG issue. Please give your thoughts in that discussion. Ed ^{[talk] [OMT]} 01:24, 12 January 2024 (UTC)Reply[reply]

add

103.253.27.33 (talk) 22:32, 14 January 2024 (UTC)Reply[reply]

 Done Largoplazo (talk) 01:01, 15 January 2024 (UTC)Reply[reply]

Currently NOFORCELINK says Use a link when appropriate, but as far as possible do not force a reader to use that link to understand the sentence. The text needs to make sense to readers who cannot follow links. Users may print articles or read offline, and Wikipedia content may be encountered in republished form, often without links.. The literal interpretation of this My interpretation of this is that it requires that every word that could be considered specialist ("turboprop", "action platformer", "Laplace transform", "endpaper", ...) be explained in the text. I believe this is impossible and would be bad writing if it were possible. This has come up before, so I'll ping in everyone who was in that conversation, but what prompted me to post here was seeing a request from Gog the Mild in a current FAC (nominated by Aoba47) to clarify "action platformer". I think Gog's request is in sync with what NOFORCELINK actually says, but I don't think the change they are requesting is desirable.

In the discussion from last year, linked above, I wrote if knowledgeable readers feel that the flow is being broken up too much by inline explanations, non-knowledgeable readers should accept that, and be willing to accept links instead, or, if absolutely necessary, an explanatory note, and NebY was kind enough to say they thought this was a guiding principle. I won't repeat the examples from the linked discussion, but I recommend reading it as there are good arguments made on both sides.

I propose we insert into NOFORCELINK a form of words that codifies the "guiding principle" quoted. I think this is going to be difficult to do because we can't explicitly give a local discussion at a WikiProject authority over other editors -- this is the WP:LOCALCONSENSUS point that SMcCandlish often argues, and he's quite right. I think it's worth trying to do because as it stands NOFORCELINK has no get-out clause for an editor who argues that "bench-clearing brawl" requires an in-text explanation in an article about a baseball game. NebY's example in the prior discussion parodies what such an article would look like, and is a better argument than anything I could come up with.

If we can't add something like this, at least we should weaken the guidance to make it clear there are exceptions. Maths is the most obvious exception, to me, but the wording should make it clearer what the limits of "as far as possible" are, and to weaken or remove "The text needs to make sense to readers who cannot follow links."

Pinging from previous discussion and the current FAC: J Milburn, Lee Vilenski, Bagumba, Uanfala. Mike Christie (talk - contribs - library) 22:52, 17 January 2024 (UTC)Reply[reply]

While, as ever, willing to listen to other opinions, my first thought on "if knowledgeable readers feel that the flow is being broken up too much by inline explanations, non-knowledgeable readers should accept that, and be willing to accept links instead, or, if absolutely necessary, an explanatory note" is to disagree. We are an encyclopedia, we are here to explain things for non-knowledgeable readers - that is actually our mission statement. To codify the generation of in-group language and articles which can only be understood if you already understand them is an admission of project failure. And I don't feel that setting up a straw man in the introductory remarks - " The literal interpretation of this requires that every word that could be considered specialist ("turboprop", "action platformer", "Laplace transform", "endpaper", ...) be explained in the text" - is helpful. Gog the Mild (talk) 23:11, 17 January 2024 (UTC)Reply[reply]

Fair point on the straw man so I've struck and reworded it. And I take your general point, but can we agree that as articles get more and more specialized, descending through the fractal tree of some topic or other from the overview article to highly specialized articles such as sheaf (mathematics), eventually NOFORCELINK becomes actively unhelpful? I'm arguing that we should acknowledge that fact in the wording. Mike Christie (talk - contribs - library) 23:16, 17 January 2024 (UTC)Reply[reply]

We certainly can, and we can then haggle over where we draw the line. Can we also agree that whatever is decided only FAC cares about it? It makes no difference whatsoever to any non-FA article, no one is going to be deleting text for non-compliance. GAN (and ACR) have even institutionalised non-compliance. Gog the Mild (talk) 23:37, 17 January 2024 (UTC)Reply[reply]

And I really struggle to see how "as far as possible" equals "it requires that every word". It simply don't, it requires it "as far as possible", and no further. So sheaf (mathematics) already has its "out" and I look forward with interest to seeing what there is to discuss. Gog the Mild (talk) 23:37, 17 January 2024 (UTC)Reply[reply]

Leaving my opinion to one side, re 'weaken or remove "The text needs to make sense to readers who cannot follow links." ', have you run this past the accessibility people? Their objection is usually taken to be the end of a discussion. Gog the Mild (talk) 23:47, 17 January 2024 (UTC)Reply[reply]

I don't think it's a coincidence that noticing a FAC discussion about this brought me here, so you're right -- it's certainly going to be mostly FAC where this is relevant. (Actually that means I should post a note about this discussion at WT:FAC. I'll do that next.) But the guidance given should be correct whether or not that's true. No, haven't asked about accessibility, but good thought, so pinging Graham87 who is always helpful on such questions. Also pinging David Eppstein who I know has contributed to this sort of discussion in the past. Mike Christie (talk - contribs - library) 00:17, 18 January 2024 (UTC)Reply[reply]

I don't think this has any special accessibility implications for users with disabilities. Graham87 (talk) 03:12, 18 January 2024 (UTC)Reply[reply]

I completely agree with Mike Christie's take that explaining literally every technical word would, in many cases, send us down an endless rabbit hole of sub-explanations and sub-sub-sub-explanations to the point where no reader can read the article. The general audience readers cannot read it because they do not have the background to assimilate all the sub-explanations all the way down the chain and the experts cannot read it because they cannot find the actual content among all the "As You Know, Bob" explanations of things they already know. We need a happy medium. I think WP:ONEDOWN does a good job of setting a target audience and therefore setting the level of what terms need expansion and what can be assumed. Any further expansion beyond that level will not help, because people more than one level down are not ready to understand the article yet and so trying to make the article understandable to them is futile. Even a single level of expansion may be too much. As an example, the current lead of prime number states: A prime number (or a prime) is a natural number greater than 1 that is not a product of two smaller natural numbers. Here the terms "natural number" and "product" are linked, but not explained, because if you do not know how to count and multiply, you are not ready to learn about prime numbers. "Greater than" is not linked but in the same boat. This is not so much an issue of accessibility as of making our articles self-contained to those who can benefit from reading them. —David Eppstein (talk) 00:40, 18 January 2024 (UTC)Reply[reply]

We have had a lot of trouble with this in the past and it has a reputation as one of the most obnoxious parts of the MOS. It directly contradicts WP:SUMMARYSTYLE. It demands that every link be explained. Our normal out at FAC and GA is that we don't have to conform to the MOS.This was added without consensus in 2015. [3] Strongly recommend restoring the original version: Do not unnecessarily make a reader chase links: if a highly technical term can be simply explained with very few words, do so. Hawkeye7 (discuss) 00:50, 18 January 2024 (UTC)Reply[reply]

Strongly disagree. That is not a good rule, because it does not generate a method that terminates in a bounded number of expansions. It is entirely possible to have a highly technical term that can be simply explained with very few words, some of which are themselves highly technical but can be simply explained with very few words, some of which are themselves highly technical but can be simply explained with very few words, etc. In fact the chain of explanations may even be circular. We need a rule that tells us the level of explanation that is appropriate: which highly technical terms need expansion because they are technical even to people ready to read the article, and which highly technical terms should be left to stand because if you don't already understand them you also won't understand anything else that follows. WP:ONEDOWN is that rule. —David Eppstein (talk) 00:58, 18 January 2024 (UTC)Reply[reply]

Yes, we already have this covered. And "do not force a reader to use that link to understand the sentence" does notmean "make the material understandable to a five-year-old", it means if the sentence is outright confusing to the average reader then probably needs some clarification. Confusing does mean "not sure what this word means", confusing means "can't even really parse the sentence as meaningful". Any of our physics articles (to pick a technical topic at random) like graviton and string theory and even elementary particle contain plenty of technical terminolgy from the lead sentence, but even someone who doesn't know what most of them mean for certain can pick out at least a bare gist of it even if they have to look some stuff up. If they don't understand any of these terms at all, then they need to start with a more basic article. We aren't going to right in the lead sentence explain what a quantum is, explain what physics in, explain what a particle is, explain what a point is, explain what gravity is, etc. All of such articles could probably be improved but they are not fundamentally broken.  — SMcCandlish ☏ ¢ 😼  01:44, 18 January 2024 (UTC)Reply[reply]

There is always going to be room for disagreement on which technical terms need explanations and which don't, because different people have different levels of knowledge. I know what a graviton is but not what an action platformer is. It might also depend on the type of article and whether its readers can be expected to know a term. I think the question is most important in FAC and content review processes; I usually explain the term when asked, unless it is intuitive for laypeople.

There is a separate question of where to put explanations when they are needed. I generally put them in footnotes, not inline, because the explanations are distracting and break the flow of the text.

Jo-Jo Eumerus (talk) 09:33, 18 January 2024 (UTC)Reply[reply]

My interpretation of how this should work is that it's important to explain information that is required to understand the content. Taking wording from my field of view, something like John Higgins made a century break of 104. - a century break is a phrase that under the current wording would have to be explained in every snooker article as "a series of shots which gives a score of over 100 in one turn", which is overkill except in the article in which we link. However, you can easily move on from this sentence if you dont know what a century break is, it's enough to know that he did a thing.

The difference is when the information is required information for future reading within that article. We shouldn't force readers to click outside links to understand the article you are reading, but equally we shouldn't be causing readers to read an explanation for every term. So, another example where we might need to explain would be the event was played as a double-elimination tournament. I think most readers would have difficulty understanding this, and even if you do know what this is, you wouldn't worry too much about a later sentence saying players who lost one match would be moved to the "loser's side" of the bracket and be eliminated after a second loss. for example. The last thing we should do is be explaining every link inline. Imagine if we had to explain what a goal, a battle or a table is. Lee Vilenski ^{(talk • contribs)} 10:00, 18 January 2024 (UTC)Reply[reply]

The key words are as far as possible. Articles are not limited to experts, but it shouldn't be bogged down for people with a bit of familiarity. WP:ONEDOWN is mentioned by some below.—Bagumba (talk) 09:54, 19 January 2024 (UTC)Reply[reply]

I suspect what I'm going to say here will be unpopular, but that's never stopped me before. I think Users may print articles or read offline, and Wikipedia content may be encountered in republished form, often without links is an obsolete concept. Wiki says A wiki ... is a form of online hypertext publication Right there in the lead sentence it emphasizes "online" as well as "hypertext". These are fundamental attributes of what we are.

Yes, our license allows people to print articles out, and I'm sure some people do, but that's an exceptionally minor edge case. And, yes, people do republish our stuff on-line, but if they're republishing it in a form which doesn't preserve the links, they're doing it wrong. A lot of that is SEO fodder, click-bait, or just plain plagiarism which fails to comply with even the trivial requirements imposed by CC-BY-SA. I care not a whit about the quality of the experience provided by those bottom feeders. As for off-line reading, Enwiki is 4.3 billion words, so figure 25 GB (probably more like 3 GB compressed). Even low-end phones these days have enough storage to load the entirety of enwiki. So there's no good reason why the off-line experience can't include links.

I'm not saying we shouldn't be providing in-line explanations of terms when it's appropriate. Just that we shouldn't be letting obsolete concepts of how people consume the encyclopedia be a significant driver of our writing style. It's a good thing for us to say "we allow (even encourage) you to do this". It's also a good thing to say "we'll expend significant resources (XML dumps, etc) to facilitate you doing this". It's not a good thing to say "we'll degrade our product to accommodate you doing this".

I'm absolutely in support of making our content more accessible to people with disabilities, but I'm not convinced that providing in-line explanations of every link is a positive step. I know in my own reading, concise writing aids my comprehension. If I have to wade through parenthetical explanations of terms to get to the meat of the sentence, it's harder for me to understand. RoySmith (talk) 16:54, 25 January 2024 (UTC)Reply[reply]

It would be wonderful if it were obsolete. Unfortunately the privilege of bandwidth is not evenly distributed around the world - there are millions of users of offline versions of Wikipedia. Nikkimaria (talk) 00:00, 26 January 2024 (UTC)Reply[reply]

Gog's point that a change to NOFORCELINK would mostly affect FAC seems plausible to me, so I searched the promoted FAC pages for uses of NOFORCELINK and FORCELINK. That only finds the few reviewers who use this shortcut rather than simply requesting further explanations without linking to the MoS; there are certainly other reviewers who make the same points. With that caveat, here are some of the results. Some of these seem clearly legitimate requests and are why we have NOFORCELINK; others seem to me to be requesting more than is needed. I tried searching for "gloss" but in many of the results I found the comment was "since there's no link for this specialist term we need a gloss instead"; those are not relevant as the reviewer is clearly saying that just a link is enough.

In a couple of cases below I've given the outcome, just to reinforce the point that many of these are perfectly legitimate applications of NOFORCELINK.

• member of the Société Honoraire de Français from the FAC for Lisa Nowak. Nominators Neopeius and Hawkeye7; reviewer requesting the explanation The Rambling Man. Current wording in the article: member of the Société Honoraire de Français, which required students to maintain an A average in French and a B average in all other subjects. I think a link would have sufficed here.
• possibly because of Jacobite sympathies from the FAC for Thomas Hardy (Royal Navy officer, died 1732). Nominator Pickersgill-Cunliffe; reviewer requesting the explanation Gog the Mild. Current wording in the article: possibly because, as a Tory, he continued to support the deposed House of Stuart after the succession of the House of Hanover. Particularly given that this is in the lead I think the expansion was the right call.
• A long list of words, including gracile, holotype, and braincase, in the FAC for Bajadasaurus. Nominator Jens Lallensack; reviewer The Rambling Man. That FAC contains a debate about the usage of NOFORCELINK with comments from multiple reviewers.
• 137 break from the FAC for 2022 World Snooker Championship. Nominator Lee Vilenski; reviewer Gog the Mild. I think this is the one that led to the last NOFORCELINK discussion.
• frigate in the FAC for HMS Aigle (1801). Nominator Ykraps; reviewer Gog the Mild.
• "a metal cast plaque in champlevé (carved) enamel in the FAC for Clonmacnoise Crozier. Nominator Ceoil; reviewer Gog the Mild. Current wording in the article is simplified rather than expanded: in champlevé enamel.
• "Tribal Hidage" in the FAC for Benty Grange hanging bowl. Nominator Usernameunique; reviewer UndercoverClassicist.
• hero pulp and weird menace in the FAC for The Spider (magazine). Nominator Mike Christie; reviewer UndercoverClassicist.
• Chagatai literature in the FAC for Fuzuli (poet). Nominator Golden; reviewer UndercoverClassicist.
• A reverse usage: in the FAC for I Don't Wanna Cry, nominated by Heartfox, reviewer MaranoFan questioned the details of a sentence and Heartfox responded that it was required by NOFORCELINK.

David suggested that WP:ONEDOWN is the principle that should be used to determine whether more than a link is required. I like that idea in theory but would like to see that it would be helpful in resolving the above examples. For example, in the FAC for The Spider, UC requested glosses for "weird menace" and "hero pulp". Is the ONEDOWN level a reader who knows about pulp magazines but not about this one? If so no gloss is needed. Or is the ONEDOWN level a reader who knows about the magazine industry but not pulps? In which case a gloss is likely to be helpful. Mike Christie (talk - contribs - library) 13:40, 18 January 2024 (UTC)Reply[reply]

For what it's worth, as I seem to feature quite frequently up here, my principle is that we should explain a term in text if:

a) We think it is important for a reader to understand that term, in order to understand its significance in the article.

b) We think that at least a significant chunk of the readership won't automatically understand that term, bearing in mind that we write assuming that our audience don't generally have much background knowledge outside the article.

c) Explaining the term is relatively "cheap" (that is, a succinct, useful explanation exists, which can be inserted into the article text without creating other problems of readability, verbosity or general barbarity).

Echoing Mike, I like the idea of ONEDOWN as the basic standard, but would emphasise his point that it's always going to be a nuanced decision: I'd suggest that any too-monolithic set of rules is likely to fail. UndercoverClassicist ^T·C 14:21, 18 January 2024 (UTC)Reply[reply]

Over the years, FAC reviewers pushed me to avoid more and more technical terms. In hindsight, I am pretty happy about that, as I want people to understand these articles. I am still surprised how much is possible here that really makes a difference to the reader. Providing in-text explanations is only one possible solution. Sometimes, a little hint is sufficient (e.g., writing "Late Cretaceous epoch" instead of just "Late Cretaceous"). Often, it is possible to replace the term with a more widely understood one without sacrificing too much precision, or even replacing the term with an explanation. But I first had to learn this the hard way, which was not easy, and I was quite reluctant to stop using terms that, for me, are part of every-day language. So I think that having a guideline that pushes authors towards this direction is not necessarily a bad thing!

But we always have to remember: It is not our goal to strictly abide to guidelines. Our goal is to write the best-possible articles. Guidelines can only help us with that, but they can never be the goal themselves. When we start optimizing our articles to comply with a guideline, article quality tends to improve – but there inevitably comes a point where we over-optimize and article quality decreases sharply. Therefore, a reviewer should not make the mistake to blindly check an article against a particular guideline and oppose because of non-compliance, possibly without even reading the article. Instead, a reviewer should always have our primary goal in mind (to improve the article), and apply common sense with respect to the article in question, asking "could this article be improved by more closely abiding to that guideline"? --Jens Lallensack (talk) 16:12, 18 January 2024 (UTC)Reply[reply]

Hyperlinking allows us to provide our readers a higher level of service than is possible in print media. We shouldn't try to emulate that high level by also adding inline explanations that are disruptive for most readers, even those who aren't online.

Print readers know very well that if we see unfamiliar terms, we may have to look elsewhere for definitions. Sometimes we make a good guess, sometimes we keep going because we're not trying to understand everything, sometimes we'll find a glossary in the back, grab a dictionary or primer, or look on Wikipedia. Print writers and publishers know they'll lose their target audience if they keep interrupting their reading, and WP editors should learn from them if we really are writing for those who print our pages (an ever-shrinking proportion of readers in this digital age, plus some publishers of expensive print-on-demand collections of our articles).

Happily, many of our articles, even FAs, don't explain inline and often don't even link (century break, to take one of Lee's examples above, top of the fourth, right field foul pole and the others I mentioned before, or second yellow card, edging a delivery, or false flat). They're still good articles. Wikipedia editors shouldn't be told to degrade them to cater for print readers in ways that print publishers can't and don't. NebY (talk) 18:13, 18 January 2024 (UTC)Reply[reply]

• I have wrestled with this question as both writer and reviewer, and I'm still forming my own views. I believe at the outset, though, that we need to recognize that at some level the audience for every article is different; geographically, educationally, linguistically. I don't think it is possible or desirable for every article to be equally accessible to all readers (I'm not setting up a straw man here — I don't believe anyone is advocating for this — I'm only expressing a principle). As such it seems to me the guideline should be written such that explanations can be provided or requested based on a) the degree of specialization in the article, and b) editorial judgement. Vanamonde93 (talk) 18:28, 18 January 2024 (UTC)Reply[reply]

In response to NebY's suggestion that inline explanations only benefit print readers: there's a wider picture to consider here. Most obviously, there are people who, for accessibility reasons, cannot or cannot as easily follow hyperlinks (those using screen readers). There is also a major cognitive load issue with requiring people to navigate away from a page, and so break their flow of concentration, and then to return back to it: again, that's an accessibility issue when we consider things like ADHD and dyslexia, which affect a sizeable chunk of our readers. UndercoverClassicist ^T·C 18:37, 18 January 2024 (UTC)Reply[reply]

Those are good points, but I'm not suggesting that inline explanations only benefit print readers. I am arguing against inline explanations that are disruptive, pointing out that we often do without them, quite rightly, despite NOFORCELINK, and generally expanding on your qualification of your well-made point (c) above. As you go on to say, it's always going to be a nuanced decision; one useful way to approach it is "would print media insert such an explanation here?" NebY (talk) 19:03, 18 January 2024 (UTC)Reply[reply]

If the term can be explained in two or three words, an inline description might be appropriate. If not, then I'm of the opinion that a link on its own is the better option. After all, isn't that the great advantage of a digital encyclopaedia. I certainly wouldn't fail a FAC because of NOFORCELINK but might insist on a footnote where no link is available. --Ykraps (talk) 18:56, 18 January 2024 (UTC)Reply[reply]

I agree with the idea of applying WP:ONEDOWN to both explanations and links. The text should make sense to its target audience, without following links (but that doesn't mean the reader can avoid hard thinking or re-reading tricky sentences). Thus, a "zero levels down" idea might be both linked and explained. A "one level down" idea might be linked only (for any "two levels down" readers; or to fill in the occasional knowledge gap of a target reader). Anything "two levels down" or more goes unlinked.

In Scott–Curry theorem (created by me), the meaning of set is obvious (more than two levels down), so it goes unlinked and certainly without a lengthy definition. In Addition the same word needs a link. In a non-maths article it may need a link and explanation ("the artist was inspired by the concept of a set, which contains distinct, unordered objects"). — Bilorv (talk) 21:44, 18 January 2024 (UTC)Reply[reply]

I have always taken "the average reader" to mean "the average reader of this particular article". I would presume that someone reader an article about a football match knows something about football. The reader of a highly technical article probably has a solid background in the subject and is looking for some detailed information. Mathematical articles sometimes have trouble in this regard, as they may be turned to by a broad audience, so they tend to start simple and get more complicated as you go along. WP:ONEDOWN also conflicts with NOFORCELINK (as does WP:NOTPAPER) but I would favour applying the former to links instead of the unenforceable NOFORCELINK. Hawkeye7 (discuss) 00:50, 19 January 2024 (UTC)Reply[reply]

At the risk of putting in a lot of oars here, it's worth remembering that there are plenty of avenues -- DYK, Random Article, On This Day, TFA... -- by which we encourage people to look at articles outside their normal areas of expertise. Articles also often cross into different areas: I've written a lot of biographies of academics who did military service, so we end up with quite a lot of technical language and detail about ranks, units, wars and so on. Again, I think the basic concept is sound, but will be tricky to turn into a hard-and-fast rule that applies across all types of article. NOFORCELINK is already part of the MoS, and the whole MoS has the standing caveat to the effect of "all rules here should be treated as general guidelines and disregarded when appropriate": by definition, when a reviewer cites it, they're saying that they think it's right to apply it here, not that it should be blindly applied everywhere. UndercoverClassicist ^T·C 07:34, 19 January 2024 (UTC)Reply[reply]

Wording proposals

There's enough support above for something based on ONEDOWN to try to formulate something here. Currently NOFORCELINK says:

Use a link when appropriate, but as far as possible do not force a reader to use that link to understand the sentence. The text needs to make sense to readers who cannot follow links. Users may print articles or read offline, and Wikipedia content may be encountered in republished form, often without links.

and ONEDOWN says:

A general technique for increasing accessibility is to consider the typical level where the topic is studied (for example, secondary, undergraduate, or postgraduate) and write the article for readers who are at the previous level. Thus articles on undergraduate topics can be aimed at a reader with a secondary school background, and articles on postgraduate topics can be aimed at readers with some undergraduate background. The lead section should be particularly understandable, but the advice to write one level down can be applied to the entire article, increasing the overall accessibility. Writing one level down also supports our goal to provide a tertiary source on the topic, which readers can use before they begin to read other sources about it.

ONEDOWN is an essay so rather than refer to it I think we have to rephrase it and summarize it. How about these extra sentences?

The text needs to make sense to readers who are at or one step below a level of study that would familiarize them with the material. For example, in an article on spinal medical issues, it would suffice to link facetectomy without an inline explanation; if the term were used in an article about general medical treatment it might need a footnoted explanation, and in an article not about medicine at all, the meaning of the term would have to be explained inline.

This is just a way to get the wording discussion started; please criticize or suggest changes or improvements. Mike Christie (talk - contribs - library) 15:05, 19 January 2024 (UTC)Reply[reply]

I like it Lee Vilenski ^{(talk • contribs)} 15:40, 19 January 2024 (UTC)Reply[reply]

WP:ONEDOWN is not an essay, but rather part of Wikipedia:Make technical articles understandable, which is an editing guideline. —Bagumba (talk) 16:04, 19 January 2024 (UTC)Reply[reply]

I must admit that I like everything except the specific example here: a large chunk of the audience for spinal medical articles are patients who might have been given a diagnosis of e.g. cervical rhizalgia and want to look up what that means -- those people definitely do need facetomy explained to them in the context of "this might be a surgery that happens to you". I'd propose a more abstract hierarchy whereby we have three options:

1. Explain the term in text (not necessarily a full definition or context, but enough to understand its function in this situation)

2. If that's felt to be too awkward for readability, add an EFN explaining the same.

3. If that's felt to be unnecessary, simply use the link.

Personally, I'd favour a model whereby 1. is the default and general practice, 2. is used where the explanation isn't that important and the readability/aesthetic hit is felt to be significant, and 3. is used only where the term is considered to be at least two steps below the reader's expected level, and it is felt that both 1. and 2. would require excessive tradeoffs (for instance, that there are so many technical terms used that explaining/footnoting them all isn't sensible). However, I think I'm slightly more hawkish than the overall consensus on this latter point. 16:13, 19 January 2024 (UTC) UndercoverClassicist ^T·C 16:13, 19 January 2024 (UTC)Reply[reply]

I personally feel that this is too specific and too rigid to be a general guideline. I like the idea behind ONEDOWN, it is good rule of thumb, but as was already noted, I also think it is only applicable to parts of our articles. We often do not have such clear hierarchical levels. For example, a highly specialized article about a roman vase can get considerable public attention if it is exhibited in a museum. And since we are mostly concerned with FAC here: Every specialised FA will get considerable attention from general readers when it is on the main page as TFA. I would prefer something simpler and more general here instead. Maybe: It is recommended to provide inline explanations for terms that are crucial for the understanding of the text or might be unfamiliar to the target readership. However, the article should find a balance between the number and length of inline explanations and the overall conciseness and readability of the article. Jens Lallensack (talk) 17:00, 19 January 2024 (UTC)Reply[reply]

I like this: perhaps add a suggestion that footnotes can sometimes be a useful compromise when striving for that balance? UndercoverClassicist ^T·C 17:10, 19 January 2024 (UTC)Reply[reply]

Yeah; I personally think that footnotes are great when some lengthy explanations are required. When it comes to simple definitions of terms, though, they are imo not so much better than simple wiki-links (as both require a click), at least for online readers. --Jens Lallensack (talk) 17:17, 19 January 2024 (UTC)Reply[reply]

Footnotes include a link back to precisely where the reader was before, whereas wikilinks don't -- but it's a fairly minor difference, as we always have the browser's "back" button and then scrolling/ctrl-f-ing to wherever on the page we were. UndercoverClassicist ^T·C 17:19, 19 January 2024 (UTC)Reply[reply]

I think we also need something to avoid the situation that NebY parodied in the earlier discussion: if an article on a baseball game gets to the front page, many readers who know nothing of the sport will read it, but we still should not include footnotes *or* inline explanations for terms such as "inning", "base on balls", "bench-clearing brawl", or "infield fly rule". Jens said "might be unfamiliar to the target readership". We should rarely expect that the target readership is the same as overall Wikipedia readership, or this wording change won't achieve anything. Mike Christie (talk - contribs - library) 17:26, 19 January 2024 (UTC)Reply[reply]

I feel strongly that if a reader needs to look up links to understand an article in general terms, which they probably would for the second and last expressions above, then it does not "exemplify Wikipedia's very best work", so would not become an FAC nor a TFA and thus the hypothetical example seems moot. Gog the Mild (talk) 18:05, 19 January 2024 (UTC)Reply[reply]

You may be right, but it strikes me that the net effect here is the same: either way, we shouldn't plead that an article expects an unusually technically-expert audience to avoid explaining technical terms, which weighs against strictly using ONEDOWN and towards something more like what Jens proposes. UndercoverClassicist ^T·C 18:19, 19 January 2024 (UTC)Reply[reply]

@Mike Christie: You are right that the part about the target readership is not ideal. What about: It is recommended to provide inline explanations for the most difficult terms of an article, so that the widest possible audience can directly understand the article in general terms without having to follow wiki-links. This still retains some element of ONEDOWN as it is restricted to the "most difficult terms" ("most difficult" relative to the overall technicality of the article in question). But yes, this would mean that even the baseball article should provide such explanations to a reasonable extent (and I think, why not?). Jens Lallensack (talk) 23:40, 19 January 2024 (UTC)Reply[reply]

Of course it's "reasonable extent" that's going to be hard to define, though. I think Brooklyn Dodgers 1, Boston Braves 1 (26 innings), a recently promoted FA, is a good test case. The nominator was Wehwalt; Harrias reviewed it and there was an exchange in the FAC about whether the level of jargon was appropriate - worth having a look at Harrias and SchroCat's comments as neither are baseball aficionados. If you can find a form of words that supports the wording that Wehwalt ended up with, and which passed FAC, I think that's what we're looking for. I feel NOFORCELINK's current wording doesn't support the FAC version, and I don't think your proposed wording does either. Or do you think the article is in fact too jargon-heavy? Mike Christie (talk - contribs - library) 03:43, 20 January 2024 (UTC)Reply[reply]

As I expressed here, sport articles are necessarily going to use the language of sport. As I noted in the above comments to Harrias, which did not receive a reply, that is true regardless of whether it is a baseball article, or football (as in the FA nominated by Harrias that I examined for the identical fault they had found in my article they had reviewed), or cricket (which, had I chosen one of those articles, would surely have made my point more than amply, but I invoked the mercy rule).

It is impossible to avoid using the language of sport, and if you slow to explain each term as you go, you not only make the prose difficult for those who may actually use the article, but cause WP:V problems, for certainly a baseball source that tells us that the designated hitter scored with one out and the bases loaded on a squeeze play after being unable to advance on a pop fly on which the infield fly rule was called will not stop to explain each term. If linking is not sufficient (and it should be), the editor will either have to insert their understanding of each term, go to a myriad of definitional sources, or dumb it down, losing meaning important to baseball readers. The reasons for doing this do not seem strong enough. Wehwalt (talk) 11:42, 20 January 2024 (UTC)Reply[reply]

I would assume that inline explanations are covered by WP:BLUE and do not need a citation? I have inline explanations in all my FAs and never provided an additional source for them; it is not material that is "challenged or likely to be challenged". Jens Lallensack (talk) 12:21, 20 January 2024 (UTC)Reply[reply]

I don't think you can use BLUE for a technical term. Especially when you have a dedicated article to explain it. In my field, a foul and a miss would be something that has quite a few interpretations, and the rules can be quite oblique. In practice, using a term like that it isn't all that relevant that you know what it is, or how it happens, if the next sentence says what happened next. Lee Vilenski ^{(talk • contribs)} 12:54, 20 January 2024 (UTC)Reply[reply]

Article writing is not possible without interpretation of the sources. This includes interpretation of the terms that are used in the source. Adding an inline explanation does therefore not really add new information that is not somehow implied in our writing anyways, in my opinion. Citing those things is citation overkill. Jens Lallensack (talk) 13:12, 20 January 2024 (UTC)Reply[reply]

Thats the thing though, if you start extrapolating like that, you don't cite anything. An explanation of what something is isn't really as simple as explaining what you see. Considering we are talking about FA level articles, I wouldn't be happy with an article like that just stating an interpretation without a single source. Lee Vilenski ^{(talk • contribs)} 15:47, 20 January 2024 (UTC)Reply[reply]

I've mentally invoked WP:BLUE when, for example, a source says "the rebuilding happened during the reign of Justinian" -- I would say it's unreasonable to assume that our readers all know his dates, so I might write something like "the rebuilding happened under Justinian, who ruled between 527 and 565 CE". Assuming that those dates are uncontroversial, I wouldn't ask for a specific citation, but there's equally no harm in doing something like this.^{[UC 1]} UndercoverClassicist ^T·C 06:34, 26 January 2024 (UTC)Reply[reply]

UndercoverClassicist ^T·C 06:34, 26 January 2024 (UTC)Reply[reply]

(EC) Yes, it is difficult to impossible to define what a reasonable extent is. But I think that the same issue applies to your original wording – I personally have no idea how I would apply ONEDOWN to my dinosaur articles. Does it mean I should provide more inline explanations or less? The mentioned baseball article does not seem to provide any inline explanations at all; this does not seem to comply with my suggestion or with ONEDOWN?

I am starting to think if it would be best to simply remove MOS:NOFORCELINK. We would still have the point Do not unnecessarily make a reader chase links: if a highly technical term can be simply explained with very few words, do so. – which seems to cover our baseline quite well already. We also have the WP:MTAU guideline stating Wikipedia articles should be written for the widest possible general audience, which points out many different possible ways to make an article understandable, and ONEDOWN is already covered there. If, in a FAC, an article is too technical in our opinion, we can still push for better comprehensibility by pointing at those guidelines. --Jens Lallensack (talk) 12:15, 20 January 2024 (UTC)Reply[reply]

I'm not sure I've understood: are you proposing removing Do not unnecessarily make a reader chase links: if a highly technical term can be simply explained with very few words, do so from the MoS? It strikes me that everyone here is in agreement with that principle: it then creates a discussion around the word unnecessarily, which is where the nuance of each individual situation can come in. It's extremely valuable to be able to point at a MoS page to explain a rule that is generally held to be good sense, especially when we do so very often ("per MOS:NOFORCELINK" is much easier on the fingers and eyes than writing out a full explanation!). Reading again, I'm not totally sure where the boundaries of NOFORCELINK are, but I might suggest that the quoted phrase would be usefully included under it. UndercoverClassicist ^T·C 13:06, 20 January 2024 (UTC)Reply[reply]

I was suggesting to remove this part: Use a link when appropriate, but as far as possible do not force a reader to use that link to understand the sentence. The text needs to make sense to readers who cannot follow links. Users may print articles or read offline, and Wikipedia content may be encountered in republished form, often without links. I fear now that this is just not helpful. Does it mean that every important term should be explained in-line (which is arguably "possible")? We would keep Do not unnecessarily make a reader chase links: if a highly technical term can be simply explained with very few words, do so. We could formulate this one a bit more strictly if needed. But my argument is now that this sentence is enough, and that the alternative wordings suggested above by Mike and me are basically redundant to this and the WP:MTAU guideline. Jens Lallensack (talk) 13:28, 20 January 2024 (UTC)Reply[reply]

How about Do not unnecessarily make a reader chase links: if a term that is highly technical, given the likely readership of the article, can be simply explained with very few words, do so? Mike Christie (talk - contribs - library) 14:20, 20 January 2024 (UTC)Reply[reply]

I'm not seeing an improvement there: yes, it gives us a way in to discuss the bounds of highly techinical, but we've also realised in this discussion that identifying "the likely readership" of an article and putting a lower bound on their level of expertise is difficult and perhaps unwise. I think the core of Use a link when appropriate, but as far as possible do not force a reader to use that link to understand the sentence is sound: if we think that all readers will understand the term without following the link, there's no need to explain it: conversely, as far as possible gives a way out if an explanation is felt to be impractical. ''UndercoverClassicist ^T·C 14:28, 20 January 2024 (UTC)Reply[reply]

I just do not see what this sentence ("Use a link when appropriate …") adds. As an enforcable rule, it does not really work because "as far as possible" can be interpreted to both extremes. As additional advice, it still seems redundant to what we already have. Jens Lallensack (talk) 14:45, 20 January 2024 (UTC)Reply[reply]

I think there's a difference in emphasis between if a highly technical term (formatting mine) -- which suggests that we generally don't explain, unless the term is highly technical -- and as far as possible do not force a reader to use that link to understand the sentence, which errs on the side of explanation. There are plenty of terms that may not be highly technical but which many of our readers, through reasons of age, first language, education, interest etc (WP:POPE), will not understand -- I think we should generally expect editors to explain them, at least when prodded to do so at FAC, unless there's a good reason to do otherwise. UndercoverClassicist ^T·C 14:51, 20 January 2024 (UTC)Reply[reply]

But when the first sentence tells me to only explain "highly technical" terms, while the other tells me to explain all terms whenever "possible", aren't they simply contradicting each other? Shouldn't we at least combine these into a single, coherent point, to make this useful? Jens Lallensack (talk) 14:59, 20 January 2024 (UTC)Reply[reply]

I'm not sure: compare an instruction like:

At the start of a sentence, use a capital letter. You should use a capital letter for proper nouns.

We don't understand the two to be contradictory. With that said, you're right that it would be neater, more elegant and generally better to roll the two into one statement. UndercoverClassicist ^T·C 15:27, 20 January 2024 (UTC)Reply[reply]

You are probably right. But still, it is very unclear what "as far as possible" means. How would you apply it to the baseball article mentioned by Mike? What would be a good reason to not follow this guideline? Jens Lallensack (talk) 15:43, 20 January 2024 (UTC)Reply[reply]

I think it's a mistake to expect or ask the MoS to be hard-and-fast: we already have plenty of deliberately vague statements of the same kind, so as to make any individual implementation a matter of nuance, discussion and consensus. A couple of examples I picked out fairly randomly -- all emphasis mine:

• Unjustified changes from one acceptable, consistently-applied style in an article to a different style may generally be reverted.
• A title should be a recognizable name or description of the topic that is natural, sufficiently precise, concise, and consistent with those of related articles. If these criteria are in conflict, they should be balanced against one another.
• [For section titles] Normally use nouns or noun phrases: Early life, not In early life
• In rare cases, a hyphen can improve clarity if a rewritten alternative is awkward, but rewording is usually preferable

UndercoverClassicist ^T·C 16:00, 20 January 2024 (UTC)Reply[reply]

"As far as possible" is very strong - it's always possible to include explanations. I'm seeing various overlapping conditions here for inserting an inline explanation: the term

• might be obscure or unknown to the likely readership
• is unlikely to be intuited in context
• must be understood to understand the sentence (or article?) (or to put it another way, a failure to understand it would have a marked impact)
• can be simply explained in a very few words.

Whether that can be expressed in a very few words is a challenge. NebY (talk) 14:57, 20 January 2024 (UTC)Reply[reply]

Yes. I personally use an additional condition: I will provide in-line explanations if the term cannot be easily understood even when consulting the link. This is the case when the context is crucial for interpreting the term. Jens Lallensack (talk) 15:36, 20 January 2024 (UTC)Reply[reply]

@Mike Christie: I guess that your addition "given the likely readership of the article" is needed if we accept that the baseball article can do without any inline explanations despite having numerous technical terms (do you think we already have a consensus for that?), as otherwise it would fail this condition. Jens Lallensack (talk) 15:32, 20 January 2024 (UTC)Reply[reply]

I'll just point out that explanations of 'technical' language don't always have to be inline. Footnotes are also a good way of allowing the text in the body to flow naturally for those who understand the topic while providing an on-the-page explanation for those who don't catch every nuance of every word or term. My personal preference is to keep the body's language understandable enough for as wide a selection of an English speaking audience as we can, but sometimes that's not always easy without dumbing down and annoying a large proportion of readers, so some flexibility in the MOS, the writing and the readers is required, although it's doubtful you'll ever manage to please anything but one of those groups at any point. - SchroCat (talk) 15:44, 20 January 2024 (UTC)Reply[reply]

Agreed, though too many of those can be disruptive too -- especially if I'm reading a topic I am somewhat knowledgeable about, I don't want to be called to footnotes to repeatedly find they tell me things I already know. Jens/UC, can we use the language I mentioned from an earlier discussion? if knowledgeable readers feel that the flow is being broken up too much by inline explanations, non-knowledgeable readers should accept that, and be willing to accept links instead, or, if absolutely necessary, an explanatory note. Ideally the test would be to always have a neutral and knowledgeable reviewer who can assess if the article could be expressed more simply. If we don't have that reviewer available I don't think we should be insisting that the article be fully understandable without following links to whoever is the most knowledgeable reviewer who shows up, no matter how far from knowledgeable they may be in practice. (This is part of the broader problem at FAC of lack of subject-matter expert reviews.) Mike Christie (talk - contribs - library) 16:30, 20 January 2024 (UTC)Reply[reply]

How about Do not unnecessarily make a reader chase links. If a technical term can be explained without disrupting the flow of the article for a knowledgeable reader, do so? Mike Christie (talk - contribs - library) 16:49, 20 January 2024 (UTC)Reply[reply]

I like it in principle, except for that explanations will always disrupt the flow to some extent (some editors even feel that inline citation used within sentences disrupt flow). It has to be a compromise. Maybe write "[…] without unduly disrupting the flow […]"?

Regarding the language from the other discussion: Do you suggest to combine it with the NOFORCELINK statement? I personally feel that this speaks to the readers ("readers should accept …"), which is awkward as they don't have a choice; we should only speak to authors. Jens Lallensack (talk) 17:57, 20 January 2024 (UTC)Reply[reply]

I was thinking that the two sentences I suggested should replace the entire existing NOFORCELINK wording. Not sure about "unduly" -- given we're in the realm of editorial judgement anyway I'd be inclined to omit adverbs as unlikely to be helpful. But with or without, do you think the wording acceptable? Mike Christie (talk - contribs - library) 19:01, 20 January 2024 (UTC)Reply[reply]

I am wondering if we really need that other sentence ("if knowledgeable readers feel …"). There does not seem to be additional advice/insight in there (?), and shorter/simpler is better imo. I am also wondering if we can do without the "for a knowledgeable reader" in the first sentence; it does not seem to add anything and sounds a bit like "knowledgeable readers" would be prioritized (which is not the case). Instead, we could maybe just add some more specific advice. What about: Do not unnecessarily make a reader chase links. If a technical term can be explained without disrupting the flow of the article, do so. Inline explanation or footnotes can be especially helpful when a technical term is likely to be unknown to many readers and unlikely to be intuited in context; must be understood to understand the sentence in general terms; or is difficult to understand in the context of the sentence by consulting the wiki-linked article. (Wording partly based on what NebY posted above). I am not sure if that second part is needed, but let me know what you think. Jens Lallensack (talk) 20:06, 20 January 2024 (UTC)Reply[reply]

Sorry, I wasn't being clear about what I meant. I meant to suggest that we change NOFORCELINK to Do not unnecessarily make a reader chase links. If a technical term can be explained without disrupting the flow of the article for a knowledgeable reader, do so. My hope is that including the point about "the flow of the article for the knowledgeable reader" covers the baseball case but "do so" doesn't prevent us from expanding and explaining as much as possible. It's an attempt to say the same thing as ONEDOWN without requiring the levels implied by ONEDOWN to be defined. Mike Christie (talk - contribs - library) 20:10, 20 January 2024 (UTC)Reply[reply]

I am ok with this wording. I still feel that "the knowledgeable reader" is not needed for the intended meaning (after all, it refers to "disrupting the flow", not to any levels). I think that the baseball case would be covered even if we remove it. But it is a minor point. Jens Lallensack (talk) 20:31, 20 January 2024 (UTC)Reply[reply]

I would support Mike's wording and replacement as a proposal. Jens' proposal also works: I'd suggest cutting the second part to a more straightforward suggestion that footnotes are an option for this thing: not sure how essential the material after especially helpful would be, but I can see the argument for giving reviewers a line like "I think this term is unlikely to be intuited in context" or similar. UndercoverClassicist ^T·C 20:13, 20 January 2024 (UTC)Reply[reply]

I also support Mike's proposed wording. Hawkeye7 (discuss) 20:29, 20 January 2024 (UTC)Reply[reply]

Jens, any objections if I start a new section proposing my wording, to see if there's consensus? I do it prefer it to your wording but if you want to discuss further or wait to see if others chime in that's fine with me. Mike Christie (talk - contribs - library) 22:23, 20 January 2024 (UTC)Reply[reply]

No objections at all, please go ahead! Jens Lallensack (talk) 22:48, 20 January 2024 (UTC)Reply[reply]

In books, I usually find footnotes go into extra detail, providing a higher level of scholarship – is that peculiar to my reading? Many Wikipedia footnotes too are similarly explanatory and expansive, so clicking to a note only to find a dictionary definition can be very frustrating. NebY (talk) 17:08, 20 January 2024 (UTC)Reply[reply]

We’re talking about a webpage, not a book - and that’s a critical difference. We have entire articles to go into extra depth. Personally I find it frustrating to hit a wall of techno babble in an area in which I’m not an expert, although I’m also frustrated when in an article on cricket I have to be told what are (for me) basic terms. Footnotes can provide a middle path between the two. I’ll repeat what I said in my first post: “some flexibility in the MOS, the writing and the readers is required, although it's doubtful you'll ever manage to please anything but one of those groups at any point“. - SchroCat (talk) 17:20, 20 January 2024 (UTC)Reply[reply]

Proposed wording

There's the beginnings of a consensus above on a proposed wording, so I am pulling it out to make a clear proposed change. I've changed the first sentence of the version discussed above to match NOFORCELINK's existing phrasing, both to make this a minimal change and because the compressed version isn't as clear.

I propose we change NOFORCELINK from

Do not unnecessarily make a reader chase links: if a highly technical term can be simply explained with very few words, do so. Use a link when appropriate, but as far as possible do not force a reader to use that link to understand the sentence. The text needs to make sense to readers who cannot follow links. Users may print articles or read offline, and Wikipedia content may be encountered in republished form, often without links.

to

Use a link when appropriate, but as far as possible do not force a reader to use that link to understand the sentence. If a technical term can be explained without unduly disrupting the flow of the article for a knowledgeable reader, do so.

This is not a formal RfC but if anyone thinks it necessary I can make it one. In any case I'd rather wait to do that until we see if this form of words does have significant support. Mike Christie (talk - contribs - library) 23:03, 20 January 2024 (UTC)Reply[reply]

Note: "unduly" added to the proposed wording per a comment below. Mike Christie (talk - contribs - library) 13:01, 23 January 2024 (UTC)Reply[reply]

Just to be clear, do you intend to keep the other existing and very similar sentence in MOS:L (Do not unnecessarily make a reader chase links: if a highly technical term can be simply explained with very few words, do so. in addition, or is this going to be replaced, too? Jens Lallensack (talk) 23:24, 20 January 2024 (UTC)Reply[reply]

My mistake -- I intended that to be replaced too as I see it as part of NOFORCELINK. I've edited the above to include that text in the "before" wording. Mike Christie (talk - contribs - library) 23:38, 20 January 2024 (UTC)Reply[reply]

As above, I'd support this wording at an RFC (and note that I consider the second sentence of the new wording and the first sentence of the old one to be equivalent -- but it's always better to tell people what to do rather than what not to do.) UndercoverClassicist ^T·C 10:04, 21 January 2024 (UTC)Reply[reply]

No objections so far, and (counting Jens and Hawkeye7 above) four supports for this version. If there are no objections in the next week or so I will make the change. Mike Christie (talk - contribs - library) 11:41, 22 January 2024 (UTC)Reply[reply]

Seems sensible to me. Lee Vilenski ^{(talk • contribs)} 13:50, 22 January 2024 (UTC)Reply[reply]

I like Jens Lallensack's earlier suggestion at #Working proposals (above) to add unduly: If a technical term can be explained without unduly disrupting the flow of the article for a knowledgeable reader, do so. It hopefully conveys that some knowledgeable readers might be somewhat disrupted by a "dumbed down" version, but it's for the common goal of making the article more widely accessible.—Bagumba (talk) 16:02, 22 January 2024 (UTC)Reply[reply]

I'm concerned that this is the sort of thing that is very subjective, and may be applied inconsistently at FAC, which as has been pointed out, is the only place it really matters. At the very least, I'd like to see some examples given. Wehwalt (talk) 19:15, 22 January 2024 (UTC)Reply[reply]

Yes, it's subjective, but so is MOS:OVERLINK. That in itself is not a showstopper. —Bagumba (talk) 07:42, 23 January 2024 (UTC)Reply[reply]

True. But MOS:OVERLINK has a long series of examples and other guidance. Wehwalt (talk) 12:28, 23 January 2024 (UTC)Reply[reply]

I'm also more sympathetic to Gog's view above - I'd prefer to privilege the non-expert reader. Nikkimaria (talk) 03:14, 23 January 2024 (UTC)Reply[reply]

I think everyone agrees that the non-expert reader should be catered to. A sentence such as After Brooklyn was retired in order in the top of the third inning, Oeschger doubled to center field to lead off the home half of the inning, and Powell sacrificed him to third base, from a recently promoted FA, can't be usefully explained to a non-expert reader without ruining the reading experience for a baseball aficionado. The current version of NOFORCELINK, in my view, makes no allowance for this limitation, and the revised wording is intended to address that -- to promote inline explanations (with the "do so" at the end of the revised wording) but acknowledge that this simplification has to be limited to avoid making the article unfit for expert readers.

Wehwalt, would the sentence I just quoted to Nikki serve as the example you're looking for? And I'd argue that NOFORCELINK is less subjective and more absolutist in its wording and that's a bad thing. You had to argue past the current wording of NOFORCELINK in the FAC for the baseball article. Wouldn't it be better to have a version that acknowledged the role of editor judgement? Mike Christie (talk - contribs - library) 11:46, 23 January 2024 (UTC)Reply[reply]

Yes, that would be a good example. Wehwalt (talk) 12:31, 23 January 2024 (UTC)Reply[reply]

I have to agree with Wehwalt's point on subjectivity, though. Don't we have double standards here? It is apparently ok for a sports article to not explain any term, but articles on other topics are supposed to. But what exactly sets the sport articles apart from the others? For my dinosaur articles, I could argue that explanations destroy the flow for dinosaur aficionados, and therefore not explain anything. Does the new wording mean that I can get away with that? Jens Lallensack (talk) 12:51, 23 January 2024 (UTC)Reply[reply]

There's nothing in the new wording about sports; I would expect it to apply to all articles. No, I don't think one could just "not explain anything" -- the proposed wording says "If a technical term can be explained without unduly disrupting the flow of the article for a knowledgeable reader, do so". A reviewer might ask for further explanations and the line at which the resulting flow is "unduly disrupted" is what editors would have to agree on. Yes, it's subjective, but I don't think we've come up with anything better than this. Mike Christie (talk - contribs - library) 13:01, 23 January 2024 (UTC)Reply[reply]

I suspect in a lot of areas, the matter under discussion is just not capable of being explained in a few words to those who know nothing about dinosaurs, or baseball, or mathematics. Therefore, I confess to being still a little perturbed at even having to post a defense to a reviewer who tells me to explain the infield fly rule when it's mentioned in passing in a baseball article, it should be understood that some articles are not basic-knowledge level in their field and require some level of knowledge before coming to the article. Wehwalt (talk) 13:13, 23 January 2024 (UTC)Reply[reply]

I suspect in a lot of areas, the matter under discussion is just not capable of being explained in a few words to those who know nothing about dinosaurs, or baseball, or mathematics: I see the frustration of having to respond to comments that we feel are unwise or ill-judged, but would it be so much of a hardship to write something like "yes, this bit's a little specialist, but there isn't really a good way to explain all of this without disrupting the flow (see MOS:NOFORCELINK), and the details are only really of interest to people who already know the basics"? It strikes me that the proposed wording, by having the word unduly, gives a very clear route to explain why an inline explanation has not been offered in a specific case. I'd hope that reviewers would consider their own sense of how disruptive an explanation would be before offering such a comment -- therefore, that if they did ask for an explanation, they would do so believing that it could be done without causing a major problem. UndercoverClassicist ^T·C 13:21, 23 January 2024 (UTC)Reply[reply]

@Wehwalt: Sure, we have to require some level of knowledge. But, if I interpret the new wording of NOFORCELINK correctly, that still means we should explain at least some terms (those for which an explanation makes the most sense, especially when they are less widely known but important for the sentence). However, the example baseball article here does not make any attempt to explain any term as far as I can see. How does this not violate the new wording of NOFORCELINK? Jens Lallensack (talk) 13:29, 23 January 2024 (UTC)Reply[reply]

I do remain nervous about "as far as possible". A harsh reviewer might insist that it's obviously possible and that this takes precedence – and was recently reviewed too! Maybe a little reshuffling and rephrasing would work: Use a link when appropriate, but if a technical term can be explained without unduly disrupting the flow of the article for a knowledgeable reader, do so. Try not to force a reader to use the link to understand the sentence. "Try not to" may be too weak but a bald "Avoid" might be too strong; is there something suitable in between? NebY (talk) 14:00, 23 January 2024 (UTC)Reply[reply]

The article does not attempt to discuss baseball terms because the accepted way of helping the reader there was to provide links. Baseball, a constructed game with fixed and not always intuitive rules, is difficult to discuss and its terms difficult to define if you are trying to discuss them or define them without any reference to baseball whatsoever, something that the hypothetical reader without knowledge of baseball would presumably need. Wehwalt (talk) 14:14, 23 January 2024 (UTC)Reply[reply]

I can't think that any reviewer (or co-ordinator) would disagree that explaining the infield fly rule from first principles is unduly disrupting the text -- I don't think any MoS change can avoid stubborn reviewers! But then the coordinators are also empowered to disregard objections which are not felt reasonable. UndercoverClassicist ^T·C 14:29, 23 January 2024 (UTC)Reply[reply]

I agree that those terms cannot be explained to a reader without knowledge, and without any reference to baseball. That is not my point: There are, I assume, many readers with basic knowledge of baseball, who know terms such as "inning", but may struggle with some terms that are more specialized. My interpretation of the new NOFORCELINK wording (also based on Mike's explanation above) would be that the article should attempt to explain those more specialized terms where they matter whenever possible (using more basic baseball terminology). So consequently, a baseball article will have to provide some explanations that improve the accessibility of the article in order to comply with the new wording of NOFORCELINK. Or do I misunderstand something? Jens Lallensack (talk) 14:32, 23 January 2024 (UTC)Reply[reply]

I don't know. Nothing extraordinary happened in the game other than it went on for a long time, which was the extraordinary thing that made it notable. If one knows enough about baseball to follow a newspaper account or a television broadcast, one should be fine. That way, of course, lies a can of worms with implications for many articles, if the test is that if one has casual acquaintance with the subject matter, every technical term should be explained inline. Wehwalt (talk) 14:47, 23 January 2024 (UTC)Reply[reply]

I like the idea with giving examples. However, I think that the examples should be entire articles, not single sentences. Only articles can find the balance between explanations and reading flow that we are looking for; we can't tell from a single sentence which explanations are helpful or disruptive in the given context. The baseball example sentence suggested above is misleading in my opinion: Most of those terms were mentioned earlier in the article already, and for this reason alone should never be explained in this particular sentence. I think that the context is more important than the sentence itself; entire articles are therefore much more helpful as examples. Jens Lallensack (talk) 14:20, 23 January 2024 (UTC)Reply[reply]

On reflection I agree that entire articles are better examples than individual sentences, for the reason you give -- at least to demonstrate cases where NOFORCELINK should not apply. The baseball article, Brooklyn Dodgers 1, Boston Braves 1 (26 innings), seems like it could work as an example. Wehwalt, I take your point that that article uses links as the way to help readers, not inline explanations. I think the question here is whether the current or proposed wording of NOFORCELINK are in sync with that approach. (Or if a better wording can be found than the current proposal.). I think the comments you received at the FAC would have been easier to respond to with the proposed wording of NOFORCELINK, because any knowledgeable reader would be annoyed by almost any inline explanations in the game paragraphs. There's an expectation in descriptions of baseball gameplay that the reader can follow along.

I think that means we need two examples: one to show when NOFORCELINK does not apply but also one to show when it does. How about radiocarbon dating for the latter? It explains terms like "anticoincidence counter" inline, and gives details about how accelerator mass spectrometry works, but does no more than link terms like tephra and varve that are peripheral to the core subject. Mike Christie (talk - contribs - library) 12:06, 24 January 2024 (UTC)Reply[reply]

As discussed above, I am not convinced that NOFORCELINK does not apply to Brooklyn Dodgers 1, Boston Braves 1 (26 innings). The article contains terms that are not even mentioned in the basic article Baseball (such as "spiked" and "wild pitch"). Above, Whewalt noted that "if one knows enough about baseball to follow a newspaper account or a television broadcast, one should be fine", but NOFORCELINK asks for a bit more: Each sentence should be understandable if possible, not only the article in general.

If we need another alternative, I could offer Bajadasaurus. The NOFORCELINK issues of this very technical and specialised article have been extensively discussed during the FAC, and the result is a good compromise (I hope). The article explains numerous terms, often in a gloss, sometimes several in one sentence. I think that it has the maximum of inline explanations that is possible without unduly disrupting flow, and could therefore be an example for the "upper bound" (which, I think, is not reached by the other two examples). Jens Lallensack (talk) 14:29, 24 January 2024 (UTC)Reply[reply]

A wild pitch is an ordinary baseball play that occurs in most baseball games, and is appropriately linked. Spiking, these days, is rarer but not unknown and is appropriately linked. They would be within the knowledge of anyone with sufficient knowledge to follow a baseball article. And the baseball article went though a TFA, the acid test of an article, without any adverse comment as to terminology.

Regarding the dinosaur article being proposed: Without too much effort, I found undefined technical terms in that article, that are not linked such as one finds with "wild pitch" and "spiking". "Margin" and "brittle deformation" to start with.

I should note that dinosaur articles at least have the advantage of describing anatomical features that are analogous to those familiar to humans. A skull is still a skull, a fundamental thing that has remained as time goes by. The reader, having such an object themselves, understands it intuitively. That's a very different situation from baseball, which is an artificial sport with idiosyncratic terminology. So I don't know if we're going to reach common ground here. Wehwalt (talk) 14:55, 24 January 2024 (UTC)Reply[reply]

More difficult baseball terms can be explained using basic baseball terminology, so I cannot quite follow the problem with the "idiosyncratic terminology". That people with a basic understanding of baseball will know all these terms as you say – I don't know. But I very much doubt that these terms are all on the same difficulty level – there will be some that are more difficult than others, and those are the candidates that might warrant explanations. This is what ONEDOWN asks for: Take the subject matter down to a lower level. And I would even argue that every article could be written "one level down", so I am not sure if there can possibly be an article for which NOFORCELINK "does not apply". Jens Lallensack (talk) 15:41, 24 January 2024 (UTC)Reply[reply]

ONEDOWN works well for topics with a single, clearly identifiable "level". What about articles that aren't that? For example, to be a "knowledgeable reader" for the entirety of the article on Elvis Presley would require an understanding of music, film, and to some extent military and general history as well. It's also an article that is likely to attract a very broad general readership. How does the ONEDOWN principle apply to this? Nikkimaria (talk) 06:18, 25 January 2024 (UTC)Reply[reply]

I think ONEDOWN was written with technical topics in mind and is hard to apply to articles like Elvis Presley. That's why I was hoping "knowledgeable reader" would suffice as a way of defining who is being written for; it doesn't depend on levels. I had a look through the Presley article to see what is explained inline (I.e. what could be considered to be because of NOFORCELINK). There's not much: acetate disc is linked but not explained, for example, but discarded X-ray plates might be considered an inline explanation for "ribs" in that sense.

The reason I wanted to rewrite NOFORCELINK was not because I don't want to explain things inline in all cases, but because I think its wording is too absolute. I would like wording that can be used to say editorial judgement has to be involved in deciding how far to go in explaining. "Knowledgeable reader" is an attempt to define that, but if even less defined wording were acceptable I could go along with it. Something like Use a link when appropriate. If it is possible to explain technical terms inline, do so, but use editorial judgement as to whether this can be done without unduly disrupting the flow of the article.. I think Wehwalt made a judgement call (for the baseball article) that almost any inline explanations would be disruptive, and I agree. I don't see how the current wording of NOFORCELINK permits that and I think that should be fixed. Mike Christie (talk - contribs - library) 08:11, 25 January 2024 (UTC)Reply[reply]

I think that's ended up as a tautology: unduly is, by definition, a matter of judging what is [due]. How would one assess that if not by us[ing] editorial judgement? UndercoverClassicist ^T·C 08:53, 25 January 2024 (UTC)Reply[reply]

Fair point. Is there a wording that invokes editorial judgement that you could support? Mike Christie (talk - contribs - library) 09:12, 25 January 2024 (UTC)Reply[reply]

Honestly, I wouldn't oppose this wording -- the perfect is the enemy of the good, and all that. To me, there are plenty of terms -- appropriate, unduly -- that already call for judgement, but I can see the value in explicitly invoking it. However, I can see the value in reinforcing the point that this is a particularly subjective "rule". UndercoverClassicist ^T·C 10:07, 25 January 2024 (UTC)Reply[reply]

That's more encouraging than I expected. Nikki, how about you? You indicated you agreed with Gog that we should privilege the non-expert reader. This wording does that less than the existing wording, by placing that exhortation under editorial judgement. Would you oppose this wording? Mike Christie (talk - contribs - library) 11:38, 25 January 2024 (UTC)Reply[reply]

The proposed wording overtly privileges the knowledgeable reader over the non-knowledgeable, which seems contrary to Wikipedia's key values. (In passing I continue to believe that such a fundamental change needs a widely advertised RfC.) Would there be an issue in deleting "for a knowledgeable reader" from the proposed wording? This would seem to address the perceived problem without overtly making comprehension for a non-aficionado optional. Gog the Mild (talk) 12:52, 25 January 2024 (UTC)Reply[reply]

Agree re an RfC. I don't want to start one unless we have at least some agreement here, though. To your point: how about the wording I suggested to Nikki above: Use a link when appropriate. If it is possible to explain technical terms inline, do so, but use editorial judgement as to whether this can be done without unduly disrupting the flow of the article? Mike Christie (talk - contribs - library) 13:31, 25 January 2024 (UTC)Reply[reply]

I disagree with the contention that it is contrary to Wikipedia's values, given our educational mission. Hawkeye7 (discuss) 00:22, 30 January 2024 (UTC)Reply[reply]

I will think on't, but my first thought is that this abdicates responsibility. This is meant to be policy, and that wording seems to barely even be guidance. I mean, given a disagreement and both parties turn to the policy to settle matters: that is not going to help a lot. The first version was clear, even though I am opposed to it.

Having thought a bit, this wording seems even worse than that originally proposed. It is effectively saying "So long as you have a link it doesn't matter whether the prose makes sense to a non-expert". The original at least preserved a fig leaf of writing for a general audience. Gog the Mild (talk) 13:54, 25 January 2024 (UTC)Reply[reply]

Yeah, I think we're heading in the wrong direction. Nikkimaria (talk) 00:00, 26 January 2024 (UTC)Reply[reply]

I'm going to stop trying to find a form of words that can get general support. I still think the existing wording does not reflect actual practice, and it would be better to find wording that reflects what we really do: we do try to improve readability for non-experts, but the reasons we don't or can't always move very far in that direction are not acknowledged in the current wording. However, the MoS is a guideline, not policy, and at FAC a nominator can always say they think the application of a MoS rule doesn't make sense for a given article. Mike Christie (talk - contribs - library) 06:47, 26 January 2024 (UTC)Reply[reply]

Example

I'm reviewing Beulé Gate by UndercoverClassicist right now. The following sentence reminded me of this discussion:

The area above the central doorway is decorated in the Doric order, and consists of an architrave in Pentelic marble, topped with marble metopes and triglyphs and made from a variety of limestone known as poros stone. Above the metopes and triglyphs is a geison with mutules, itself topped with an attic

There's nine different linked terms there and I don't konw what any of them means. Yet, the sentence makes complete sense and I know how to click to get more detail on any of them if I want. If this sentence was rewritten with parenthetical explanations for each of those terms, it would be crazy complicated and distinctly less readable. — Preceding unsigned comment added by RoySmith (talk • contribs) 00:22, 30 January 2024 (UTC)Reply[reply]

Under the current wording, if this were to be quibbled in the review, I'd plead "as far as possible": as you say, it isn't possible to include inline explanations for all of these without breaking the MoS and policy in other ways (by creating an unreadable sentence). If the guideline were changed to something like Use a link when appropriate, but if a technical term can be explained without unduly disrupting the flow of the article for a knowledgeable reader, do so., I'd give this as precisely the reason unduly is included: we're talking about architectural minutiae, so the details here are pretty immaterial to most readers: the value of the inline explanations is outweighed by the cost of doing so. Incidentally: thank you for raising this here -- it's helped me spot a couple of mistakes! UndercoverClassicist ^T·C 07:27, 30 January 2024 (UTC)Reply[reply]

My point above makes sense here. Do we need to know what the Doric order is to understand the context? This piece explains what "poros stone" is (limestone), and "pendalic marble" does pretty much stand out that its a type of marble. There are some more confusing items, such as triglyphs and mutules, but I have no idea how you'd explain them other than being architectual terms. Lee Vilenski ^{(talk • contribs)} 09:19, 30 January 2024 (UTC)Reply[reply]

On the triglyphs and geison at least, there's also a photograph immediately to the right with a caption that makes them (hopefully) fairly obvious: I'd suggest that that also would play some kind of role in the level of possible confusion and therefore the overall discussion as to how necessary/valuable an inline explanation would be. As with most things MoS, it's a cost–benefit analysis. UndercoverClassicist ^T·C 09:46, 30 January 2024 (UTC)Reply[reply]

I'd start of the second month. 2A00:23C7:4F01:1201:894B:E257:1DF6:C83E (talk) 21:52, 11 February 2024 (UTC)Reply[reply]

Editors interested in MOS:NOPIPE, and the use, creation, and modification of piped links in Visual Editor may be interested in the discussion going on at WP:VPT#Piped links with VisualEditor. Thanks, Mathglot (talk) 23:40, 3 February 2024 (UTC)Reply[reply]

Since we've changed the duplink policy to be links may or may not be suitable for the first time in a section, I've had users change this for all section headers (so even for level four headers, they have a new link). Can I confirm that when we say the first usage per section, we mean the first use per level 2 header? Lee Vilenski ^{(talk • contribs)} 15:39, 4 February 2024 (UTC)Reply[reply]

The MOS was since tweaked to "major section"[4] —Bagumba (talk) 04:00, 25 February 2024 (UTC)Reply[reply]

Ok, but what does "major" mean? Level 2 only? Level 3? I think past level 3 wouldn't qualify, but I can see arguments for 3. SMcCandlish you added in "major" to this wording. What was your intent? - Favre1fan93 (talk) 17:54, 26 February 2024 (UTC)Reply[reply]

I was unsure what the MOS meant and started this discussion over at WT:SNOOKER, regarding an article I was working on (2024 German Masters). The consensus was to limit to level 2 for snooker tournament articles. I think it's worth a discussion for further clarifying the broader MOS though, not just for snooker articles. Specifying level 2, 3, etc., and perhaps have different criteria for articles of different topics. AmethystZhou (talk) 18:05, 26 February 2024 (UTC)Reply[reply]

"Major" is level 2 (== ... ==). Gawaon (talk) 18:12, 26 February 2024 (UTC)Reply[reply]

Rather, "major" is descriptive of the depth and importance of the content. If "level 2" was meant, then "level 2" is how it would read. There are innumerable cases of L2 headings (usually toward the end of an article) that contain nothing but a sentence or two of material that is or verges on trivia. Meanwhile, some articles have various L3 subsections that contain the majority of the actual content, each of them longer than most L2 sections in most other articles.  — SMcCandlish ☏ ¢ 😼  19:05, 26 February 2024 (UTC)Reply[reply]

My intent was to curtail the sort of excessive link repetition that Lee Vilenski reports (which is obviously contrary to the intent of the change the community approved in the RfC about linking more than once per article), but without imposing or implying a mathematically rigid cut-off (we should always leave to editorial judgement that which can be left to it). Various very long and detailed articles are divided into a few sections which each consist of several subsections are that are the "main" or "major" content, with the level-2 headings just acting as grouping frames. In most cases, though, articles are divided mostly or even only into level-2 headings, with most of the content being directly under them. (And there's also of course the fact that a term/name might appear first at level-2 then be repeated 1000s of words later in another section's level-3 or level-4 subsection; it would still qualify as having reappeared within another major section, just also withing a lower-level subsection of said major section.) One size rarely fits all when it comes to article structure matters. If we think some explanation of "major" is needed (or some term it is replaced by) this can be put into a footnote instead of making the MoS line-item about this more verbose itself. It's also important to remember that consensus actually mostly lives in discussion. Someone cannot drum-beat their preferred but wrong interpretation of something in a guideline is the talk archive about implementing it in the first place contradicts them. So both the original RfC and this discussion will remain evidentiarily pertinent in any interpretation dispute.

It's normal and expected for editorial consensus to be reached on an per-article basis; we treat all of MoS this way with regard to a guideline line-item that has interpretational wiggle-room, and this is by design. (Remember that MoS is not a policy, and is intended to produce consistent and useful content for readers, and secondarily to settle inter-editor disputes about style, broadly defined.) While wikiprojects coming to a "local consensus" on such a matter across a category of articles can sometimes be problematic per WP:CONLEVEL policy (namely, when those editors' preference is against a site-wide consensus, or conflicts with equally principled preferences of editors who are not part of that in-crowd; see, e.g., WP:ARBINFOBOX), in a case like this there is no issue, because all the articles in the affected group are structurally the same, so a page-by-page re-discussion of the same question would be a redundant waste of editorial time.  — SMcCandlish ☏ ¢ 😼  19:05, 26 February 2024 (UTC)Reply[reply]

I agree that we shouldn't be too prescriptive, but perhaps a small addition that clarifies this intention would help? i.e. "Major sections will generally be detailed sections with a level 2 heading, but local consensus could determine that a lower level section is 'major'.". - adamstom97 (talk) 19:45, 26 February 2024 (UTC)Reply[reply]

I agree that some kind of clarification be good to have. I obviously misunderstood what's meant by "major section", and I suspect I'm not the only one. Though I could also live with just changing it to "level 2 section", which would simplify things. Gawaon (talk) 20:33, 26 February 2024 (UTC)Reply[reply]

Put a foonote in, though one that tries to more directly address some of the RfC rationale in addition to what was said above. A major point in the RfC was people arriving directly at [sub]sections by redirects and prominent links from other articles. While we can never "prevent" someone linking to, say, an obscure level-5 heading for some reason, this isn't common and the average reader is going to understand that they may have to scroll up a bit to make complete sense of the material. However, if a subsection is thematically devoted to a discrete subtopic, with various redirects and frequent mentions in other articles, that section being rather stand-alone is a benefit to readers (especially on mobile).  — SMcCandlish ☏ ¢ 😼  21:21, 26 February 2024 (UTC)Reply[reply]

• Indeed, SMcCandlish. This was a very bad change to the rules promoting considered linking only. When people get into these debates it's as if a reader can't type a target into the search box. Takes seven or eight seconds. Tony (talk) 04:37, 28 February 2024 (UTC)Reply[reply]