Wikipedia talk:Citing sources
From Wikipedia the free encyclopedia
This is the talk page for discussing improvements to the Citing sources page. |
|
Archives: Index, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57Auto-archiving period: 2 months ![]() |
|
![]() | To find archives of this talk page, see this list. For talk archives from the previous Manual of Style (footnotes) page see Help talk:Footnotes. |
![]() | This project page does not require a rating on Wikipedia's content assessment scale. It is of interest to the following WikiProjects: | |||||||||||||||||||||||
|
- The following discussion is closed. Please do not modify it. Subsequent comments should be made in a new section. A summary of the conclusions reached follows.
- There was not consensus to deprecate list-defined references. Some editors find it awkward, especially when editing a specific section, but other editors like that it makes the main wikitext less cluttered.
- There was 2:1 support in favor of deprecating {{reflist|refs=}} and replacing existing instances. I updated the linked documentation pages to do so. Someone will need to write a bot and follow the procedure at Wikipedia:Bots/Requests for approval. At least one editor had concerns about bots making incorrect edits. There was also discussion of whether or not such changes should be bot-flagged so they don't show up on watchlists, and whether it should be required that other changes be made at the same time. The bot approval process is designed to take these concerns into account and balance them against the proposed benefits; that would be the place to raise them. (It might be helpful if whoever makes the requests notifies the editors who participated in this discussion.)
- There is a big difference in the number of changes (and also pros and cons) between eliminating {{reflist}} to the fullest degree technically possible given the limitations of
<references>...</references>
, vs. only eliminating {{reflist}} for articles that use list-defined references. The latter was the question asked, but the former was the solution given in the proposed bot changes. From this discussion it is only safe to say there is support for the latter, and I recommend scoping the bot approval request to that. One editor did urge an "all or nothing" approach, but that was not echoed. If the first round of substitution goes well, we can always discuss more widespread deprecation of {{reflist}}. I did not update the linked documentation pages to say that {{reflist}} was deprecated outside the context of list-defined references. -- Beland (talk) 22:47, 30 May 2025 (UTC)
- There is a big difference in the number of changes (and also pros and cons) between eliminating {{reflist}} to the fullest degree technically possible given the limitations of
List-defined references are a pain for VisualEditor users. It displays "This reference is defined in a template or other generated block, and for now can only be previewed in source mode." instead of the actual content of the reference when using the VisualEditor. Modifying the references requires switching to the source code editor, but not everyone is familiar with its syntax. I don't know why the VisualEditor doesn't handle them better, it doesn't seem unsolvable from a programming perspective and I would be fine with list-defined references if it did, but unless there are plans to fix this, perhaps we should discourage it? I'm curious to know what more experienced contributors think. Alenoach (talk) 20:44, 1 March 2025 (UTC)
- VisualEditor is crap. It's VisualEditor that should be discouraged. Jc3s5h (talk) 21:10, 1 March 2025 (UTC)
- Two notes on this:
- The VisualEditor (VE) can preview a list-defined reference. Check out police jury in the VE. When I rewrote that, I used list-defined references, but no templates. In the VE, you can preview, modify, and reuse the list-defined references. You cannot add new list-defined references, delete existing ones, comment out existing ones, or replace existing ones. The VE will treat any template used within another template as just text. I don't think there is anything in the pipeline to fix that.
- Sub-referencing is meant to be the official solution to citing different pages and it is meant to be built on list-defined references, although it looks like that is causing problems for the team.
- Rjjiii (talk) 21:24, 1 March 2025 (UTC)
- Ah indeed, your way of doing it outside the "reflist" template works better with the VisualEditor. I still believe that inline references are more beginner-friendly, but your approach is a clear improvement compared to putting it in the reflist, thanks. Alenoach (talk) 21:42, 1 March 2025 (UTC)
- Two notes on this:
- Entirely agree with Jc3s5h. If the problem is that VisualEditor can't hack it, then the problem is VisualEditor. We should not warp our usage of helpful article-source organizational tactics because of bad tooling foisted on us by Wikimedia. —David Eppstein (talk) 21:37, 1 March 2025 (UTC)
- I'm disappointed that m:WMDE Technical Wishes/Sub-referencing is going off in a weird direction because VE doesn't do LDR well and they don't want to work on fixing that. Anomie⚔ 11:43, 17 March 2025 (UTC)
- It is so disappointing. I raised the issues that VE would cause for their plans over a year ago and they were dismissive about it then, seeming to frame it as beyond the scope of their project. But then like, who is it in scope for? Is there a team or even a person working for the WMF that has a long-term vision for how to improve referencing, or is the long-term plan to just hope we figure it out? There are limitations to what can be done with the current system; that's why using {{sfn}} feels like putting a puzzle together and {{rp}} is so basic. Rjjiii (talk) 00:40, 18 March 2025 (UTC)
- I'm disappointed that m:WMDE Technical Wishes/Sub-referencing is going off in a weird direction because VE doesn't do LDR well and they don't want to work on fixing that. Anomie⚔ 11:43, 17 March 2025 (UTC)
- I've tried WP:LDR on a couple of articles, and I find it to be inconvenient, especially if you're using section editing. I think we should discourage it. WhatamIdoing (talk) 06:30, 16 March 2025 (UTC)
- LDR is the preferred method for many editors. It has pros and cons, but it should not be discouraged. -- Michael Bednarek (talk) 06:36, 16 March 2025 (UTC)
- I wonder whether we could find out what percentage of articles actually uses it. There is a cost (in editor's time to learn about yet another different system) to maintaining unpopular arrangements. WhatamIdoing (talk) 02:34, 17 March 2025 (UTC)
- Template {{Use list-defined references}} has >5300 transclusions. Nobody has to learn about it; as with other citations, other helpful editors will convert citations non-conforming to an article's established style. -- Michael Bednarek (talk) 03:08, 17 March 2025 (UTC)
- So it's used in less than one in a thousand articles. That's barely any use at all.
- Yes, people do have to learn about it – if they want to be able to fix the citation formatting problem that brought them to the page; if they want to be able to remove a citation without getting an ugly red error message on the page; if they want to understand what's going on with the page so they don't have to rely on "other helpful editors", especially the ones whose "helpfulness" manifests in the form of yelling at them for not doing everything perfectly the first time. WhatamIdoing (talk) 03:16, 17 March 2025 (UTC)
- @Michael Bednarek, that seems too low? At least one list-defined reference is used in at least 179,000 articles, based on the "ref" parameter in {{reflist}} transclusions. Rjjiii (talk) 04:26, 17 March 2025 (UTC)
- I suspect that many of those uses occur in articles with mixed citation styles. But that number further clarifies that discouraging LFDs is impractical. -- Michael Bednarek (talk) 04:43, 17 March 2025 (UTC)
- Well... "discouraging" is usually a long-term and largely inactive/passive process. You just write something in some documentation and leave it for five or ten years, and let community members make individual choices. You could write something as strong as "being discouraged but not banned", but you could also write something like "relatively unpopular" or "less popular than shortened footnotes". WhatamIdoing (talk) 05:11, 17 March 2025 (UTC)
- That suggests that about 1 in 40 articles is using that, at least partially. That feels like a more plausible estimate to me. WhatamIdoing (talk) 05:08, 17 March 2025 (UTC)
- Just cruising thru, not reading the arguments: I use {reflist|refs= cos you can better read the text in source mode. Putting the refs in the body text looks like spaghetti code and can make a passage almost unreadable. And a key point: it's rare for someone editing to want to change the ref. Editors usually want to do things to the text. If you need to read the ref that's better done in reader mode. You might want to delete the ref; that is different. Wanting to make changes to ref itself are rare and are are usually like to add the date or something -- important but not usually key; you're not going to change the title or the author etc. Sometimes I have to find the ref tags in all that text, do linefeeds to get the refs out of the way to even read the text, then put them back -- not a huge deal but not excellent. Sometimes I'm like "Jeez this's a dog's breakfast, I'll just not do the edit I was intending to do." Herostratus (talk) 02:24, 24 March 2025 (UTC)
- I suggest using "<references>" rather than "{{reflist|refs=", as shown here. The difference is not significant for source editor users, but "<references>" will not make references hidden for the VisualEditor users. Alenoach (talk) 02:37, 24 March 2025 (UTC)
- Huh, it's odd that you describe straight-through wikitext as spaghetti code, because I think that the jumping-back-and-forth style of LDR is much more spaghetti-like. WhatamIdoing (talk) 04:43, 24 March 2025 (UTC)
- @Herostratus, Are you confident about "And a key point: it's rare for someone editing to want to change the ref. Editors usually want to do things to the text"?
- A while ago, an article appeared on my watchlist. I hadn't looked at it in years. There were something like 50 edits over five years. Not a single word of text was changed. WhatamIdoing (talk) 01:04, 21 April 2025 (UTC)
- Well what were all those editors doing, not seeing the connection.
- Just cruising thru, not reading the arguments: I use {reflist|refs= cos you can better read the text in source mode. Putting the refs in the body text looks like spaghetti code and can make a passage almost unreadable. And a key point: it's rare for someone editing to want to change the ref. Editors usually want to do things to the text. If you need to read the ref that's better done in reader mode. You might want to delete the ref; that is different. Wanting to make changes to ref itself are rare and are are usually like to add the date or something -- important but not usually key; you're not going to change the title or the author etc. Sometimes I have to find the ref tags in all that text, do linefeeds to get the refs out of the way to even read the text, then put them back -- not a huge deal but not excellent. Sometimes I'm like "Jeez this's a dog's breakfast, I'll just not do the edit I was intending to do." Herostratus (talk) 02:24, 24 March 2025 (UTC)
- I suspect that many of those uses occur in articles with mixed citation styles. But that number further clarifies that discouraging LFDs is impractical. -- Michael Bednarek (talk) 04:43, 17 March 2025 (UTC)
- Template {{Use list-defined references}} has >5300 transclusions. Nobody has to learn about it; as with other citations, other helpful editors will convert citations non-conforming to an article's established style. -- Michael Bednarek (talk) 03:08, 17 March 2025 (UTC)
- I wonder whether we could find out what percentage of articles actually uses it. There is a cost (in editor's time to learn about yet another different system) to maintaining unpopular arrangements. WhatamIdoing (talk) 02:34, 17 March 2025 (UTC)
- LDR is the preferred method for many editors. It has pros and cons, but it should not be discouraged. -- Michael Bednarek (talk) 06:36, 16 March 2025 (UTC)
- Well I would be pretty confident EXCEPT I now realize that adding the archive url etc, is probably pretty common. So I have to back off from that. Herostratus (talk) 02:59, 21 April 2025 (UTC)
- All of those editors were fiddling with non-content stuff, including but not limited to ref formatting.
- I increasingly wonder whether we could do a decent study about who writes Wikipedia's contents. High-volume editors do a lot of reverting/blanking, and we do a lot of fiddling with wikitext (some of which is actually useful to the occasional person, e.g., adding archive URLs), but I wonder whether newbies add more content. If a new paragraph is added (and sticks), who added that? WhatamIdoing (talk) 17:50, 21 April 2025 (UTC)
- Almost 20 years ago, Aaron Swartz made a study in which he found that Wikipedia's actual content is indeed largely written by the newbies and non-regulars. Whether that's still the case is an open question, but it sounds plausible to me. Gawaon (talk) 07:52, 22 April 2025 (UTC)
- That would be interesting and might even be useful. I know that my own editing patterns tend to shift around a lot, with bursts of content creation interspersed with assorted gnomery of many types. A lot depends on chance. I see something that needs to be fixed, and if I am in the right mood I fix it if I can, and it often leads to something else related or of a similar type. Other times I fixate on cleaning up or improving something on a larger scale, and then there are policy discussion.... Cheers, · · · Peter Southwood (talk): 12:26, 22 April 2025 (UTC)
- Well I would be pretty confident EXCEPT I now realize that adding the archive url etc, is probably pretty common. So I have to back off from that. Herostratus (talk) 02:59, 21 April 2025 (UTC)
- No, list-defined references are cleaner and more elegant than the mess you get when the reference details are embedded in the article's prose. The Visual Editor issue is best addressed by enhancing the Visual Editor and/or avoiding the {{reflist}} template as suggested below. Andrew🐉(talk) 20:31, 8 May 2025 (UTC)
New proposal: deprecate {{reflist|refs=
in favor of <references>
?
[edit]Per Alenoach above, <references>
handles list-defined references in exactly the same manner as {{reflist|refs=
, but with the benefit of VisualEditor support. Should we discourage or deprecate {{reflist|refs=
in situations where there are no other parameters passed to {{reflist}} and use a bot to replace all such occurrences with <references>
? Dan Leonard (talk • contribs) 12:49, 29 April 2025 (UTC)
- Isn't there, at the very least, a difference in font size? Gawaon (talk) 13:05, 29 April 2025 (UTC)
- Originally that was true, but since 2010 the font sizes have been the same. Compare angle, which uses
{{reflist|refs=
, versus Sheetz–Wawa rivalry, which directly uses<references>
. Both their reference lists havefont-size: 90%;
, albeit the former is styled by the CSS class.reflist
in addition to.references
. Dan Leonard (talk • contribs) 13:13, 29 April 2025 (UTC)
- Originally that was true, but since 2010 the font sizes have been the same. Compare angle, which uses
- It would be good to have the software engineering perspective, so I opened a discussion here. I hope we will get an answer about whether the VisualEditor can be improved, or otherwise the design rationale. Alenoach (talk) 13:37, 29 April 2025 (UTC)
- Oppose breaking our markup because of limitations in VE. If VE is broken the solution is to stop using VE, not to break more things. —David Eppstein (talk) 17:02, 29 April 2025 (UTC)
- Might be good to wait for a deeper understanding of the problem before taking a decision. Alenoach (talk) 17:10, 29 April 2025 (UTC)
- Ok, apparently this is the main page where the software developers handle it: T52896. It's a major issue that has been there for more than 10 years, and the inability to parse references inside templates also seriously impacts translation tools and infoboxes. One software engineer said in 2014 that fixing it would be too hacky and that there is no good and generic solution, and complained about the templates. No one is working on it, so I guess they don't plan to address the issue. Alenoach (talk) 19:57, 29 April 2025 (UTC)
- This is essentially just substing a somewhat-redundant template. When called in LDR contexts without other parameters, {{reflist}} appears to just call
<references />
and are already listed in the documentation as equivalent, so I don't see what you think would break. Dan Leonard (talk • contribs) 18:16, 29 April 2025 (UTC)
- Might be good to wait for a deeper understanding of the problem before taking a decision. Alenoach (talk) 17:10, 29 April 2025 (UTC)
- Oppose I love love love using the LDR, if it were a kitten I would carry it in my pocket with me everywhere. If visual editor is the problem, then fix visual editor. Sgerbic (talk) 17:21, 29 April 2025 (UTC)
- @Sgerbic: Note the proposal in this subsection is to require doing LDR using
<references>...</references>
rather than{{reflist|refs=...}}
, not to deprecate LDR. Anomie⚔ 18:09, 29 April 2025 (UTC)- Sorry, all this coding language is confusing to me as I am only a general editor. I love using reflist|refs, all the articles I write use this style and would hate to see something so tidy and easy to use to be replaced with something so messy and awkward. Sgerbic (talk) 18:41, 29 April 2025 (UTC)
- @Sgerbic It shouldn't be any more complicated. You can write your LDRs as you would, but instead of wrapping them in the reflist template, add <references> tags on either end. Cremastra talk 01:34, 1 May 2025 (UTC)
- That is very old school, I want to continue using reflist|refs it is so much neater. I'm not understanding why continuing as I have for the last few years is a problem. If there is a problem with visual editor then that should be fixed. Possibly I am not explaining myself well, this is an article I just rewrote a couple days ago Jotham Johnson. Sgerbic (talk) 03:15, 1 May 2025 (UTC)
- The only difference is that where you currently type:
{{Reflist|refs=
<ref name="NYT Obit">{{cite web |title=Prof. Jotham Johnson, 61, Dies; Chairman of Classics at N.Y.U. |url=https://
- (etc., all the way down, and then ending with a closing
}}
), you would instead type: <references>
<ref name="NYT Obit">{{cite web |title=Prof. Jotham Johnson, 61, Dies; Chairman of Classics at N.Y.U. |url=https://
- (etc., all the way down, and then ending with a closing
</references>
). Or, more realistically, you would do the same thing that you're doing now, and every now and again, a bot would replace the unnecessary template with the original wikitext code. - Do you understand how small the recommended change is? It's literally just a few characters difference in the whole page. WhatamIdoing (talk) 03:37, 1 May 2025 (UTC)
- The problem with every script in recognizing reflist template LDRs has existed and been investigated for over a decade. If you could fix it without hacky tape, that would be nice. Aaron Liu (talk) 10:57, 1 May 2025 (UTC)
- That is very old school, I want to continue using reflist|refs it is so much neater. I'm not understanding why continuing as I have for the last few years is a problem. If there is a problem with visual editor then that should be fixed. Possibly I am not explaining myself well, this is an article I just rewrote a couple days ago Jotham Johnson. Sgerbic (talk) 03:15, 1 May 2025 (UTC)
- @Sgerbic It shouldn't be any more complicated. You can write your LDRs as you would, but instead of wrapping them in the reflist template, add <references> tags on either end. Cremastra talk 01:34, 1 May 2025 (UTC)
- Sorry, all this coding language is confusing to me as I am only a general editor. I love using reflist|refs, all the articles I write use this style and would hate to see something so tidy and easy to use to be replaced with something so messy and awkward. Sgerbic (talk) 18:41, 29 April 2025 (UTC)
- @Sgerbic: Note the proposal in this subsection is to require doing LDR using
- I opened a bug report here. Alenoach (talk) 18:01, 29 April 2025 (UTC)
- Oppose breaking our markup because of limitations in VE. If VE is broken the solution is to stop using VE, not to break more things. —David Eppstein (talk) 17:02, 29 April 2025 (UTC)
- Strong support In addition to better visualeditor support, using
<references>...</references>
means that most of the citations will still display even if the WP:PEIS limit is exceeded. All the old reasons to use {{reflist}}, such as font sizes or responsive columns, have long since been overcome by the software. Nothing about using<references>{{cite foo|...}}</references>
for list-defined references is harder or less "tidy" than using the template, and in fact I'd argue that bracketing a long list with tags is more "tidy" than encapsulating it into a template parameter. The only thing holding us back is inertia from the days before the raw tag had feature parity with the template. --Ahecht (TALK
PAGE) 18:50, 29 April 2025 (UTC) - Oppose: visualeditor is broken, not
|refs=
. Boghog (talk) 19:37, 29 April 2025 (UTC) - I worry that deprecating the reflist template, but only for LDR is going to cause confusion. Good faith editors are likely to use reflist, as it's what they will see commonly elsewhere and only after being told of the situation understanding that the common method shouldn't be used in this specific case. LDRs are not common, so many editors could go a long time before coming across this situation. It would seem the better solution would be either to move away from using the reflist template (if it's true that <reference> tags now have all the same functionality), or from using LDRs. -- LCU ActivelyDisinterested «@» °∆t° 20:02, 29 April 2025 (UTC)
- There's no reason for anyone to use {{reflist}} in 99% of cases, LDR or not. It should be deprecated across Wikipedia, not just for LDRs. --Ahecht (TALK
PAGE) 20:24, 29 April 2025 (UTC)- I think @Ahecht is right. Most of the times, using {{reflist}} instead of <references /> is like using a template to make text bold instead of using the ordinary ''' wikitext code. Back in the day, there were several differences (importantly, the template could do columns ~15 years ago, before the wikitext code had that built in), but those differences are few and far between now, and IMO the template should only be used when non-default features are actually wanted.
- BTW, when we started using the template, we had the same arguments: Using the template is going to cause confusion, because people are used to the wikitext code. It's not actually a big deal. People figure out it. WhatamIdoing (talk) 20:56, 29 April 2025 (UTC)
- My point about confusion was in regard to a situation where reflist would be used for the vast majority of articles, but not on the few that use LDRs. A situation that would be quite different from when editors started using the template. This wouldn't be the reverse, but a janky halfway solution. -- LCU ActivelyDisinterested «@» °∆t° 08:19, 30 April 2025 (UTC)
- There is still a reason: if we ever want to add extra coding to references beyond the basic formatting that the references tag provides, having it in a template makes it easy and avoids having to persuade Wikimedia to maybe do it someday if they ever find the interest to listen to us. That is, it is more flexible and more robust.
- Beyond all that, there is another reason: changing existing reflists to references tags in millions of articles would represent an enormous clog-up of everyone's watchlists for however long it would take to do so. —David Eppstein (talk) 23:44, 29 April 2025 (UTC)
- Bots are hidden from watchlists by default, I think. Aaron Liu (talk) 03:21, 30 April 2025 (UTC)
- Yes, it's quite trivial to hide bot edits, either through preferences at Preferences → Watchlist → Changes shown →
Hide bot edits from the watchlist, or ad-hoc using the filter button on the watchlist itself. Dan Leonard (talk • contribs) 03:55, 30 April 2025 (UTC)
- Hiding bots means never seeing all the damage the bots sometimes do. I regularly check edits by bots and report on bad edits by bots. 99% of the time they are ok but that remaining 1% needs checking. I cannot do that if my watchlist is overwhelmed by thousands of bot edits.
- Also, this issue goes far beyond list-defined references: it appears to be a general issue with VE not handling templates nested inside other templates. Working around it in this case will merely take pressure off the VE developers to make VE work without doing anything about the broader problem. —David Eppstein (talk) 04:58, 30 April 2025 (UTC)
- Is that pressure having any effect anyway? Anomie⚔ 11:28, 30 April 2025 (UTC)
- Just mark everything as seen right after the fixbot does things; in the worst case you can always just filter out the fixbot (which will probably be a one-off ish bot used to answer Wikipedia:AWB/R). And the pressure with reflist has been on to ten years; no one has found a non-hacky (without
making up a list of hack templates that each wiki uses, which is a WONTFIX if ever there was one
which I agree with) solution. Aaron Liu (talk) 12:27, 30 April 2025 (UTC)
- Yes, it's quite trivial to hide bot edits, either through preferences at Preferences → Watchlist → Changes shown →
- Bots are hidden from watchlists by default, I think. Aaron Liu (talk) 03:21, 30 April 2025 (UTC)
- There's no reason for anyone to use {{reflist}} in 99% of cases, LDR or not. It should be deprecated across Wikipedia, not just for LDRs. --Ahecht (TALK
- Support : the problem seems unlikely to be solved any time soon (T52896). Maybe they underestimate how impactful the problem is, or maybe we underestimate the technical obstacles. But the VisualEditor is not a minor feature, so we should do what we can to accommodate its users. I don't see a good reason for using
{{reflist}}
instead of<references>
. Alenoach (talk) 20:31, 29 April 2025 (UTC) - Support I use list-defined references as the most convenient way of handling citations. I wasn't familiar with the technicalities which have been presented here but they seem to make good sense. I'll start using
<references>
to see how it goes.
- Note that this discussion has technical issues because of embedded tags which need considerable effort to decativate. I've just fixed Alenoach's post to turn off template bracketing which was messing up my post. We need some clerking to keep everything well-organised.
- Andrew🐉(talk) 06:51, 8 May 2025 (UTC)
Moved below per Mike Christie Dan Leonard (talk • contribs) 02:51, 30 April 2025 (UTC)Started a new draft proposal at the idea lab since this will require a fairly large site-wide RFC if implemented. Dan Leonard (talk • contribs) 22:32, 29 April 2025 (UTC)
- Dan, I'm not sure what would have been wrong with leaving the RfC here and simply advertising it. Since I'm commenting I'll mention that I use VE by preference; I never use LDR but would prefer to be able to edit those articles with VE if I come across them. I agree with some of David's points above, though; I don't think anything should be implemented that would flood watchlists, and I don't see any benefit in changing usages of reflist that are not implementing LDR. If you're going to reword this RfC, I think it should be narrowly defined. I'd specify that no bot edits should be done except when the edit accompanies an edit that would have been made anyway, to keep this off watchlists; and it should only affect LDR articles. David, the one point of yours I don't agree with is that we should leave reflist usages in place just in case someone finds them useful for parameter addition in the future. I think present value (to VE users, of whom there are many) is better than some possibly non-existent future value. Mike Christie (talk - contribs - library) 01:24, 30 April 2025 (UTC)
- One of the most basic use cases of {{reflist}} is to allow multiple columns in the reference section on sufficiently wide screens and to control how wide these columns shall be. How does the
<references/>
tag handle this? Sorry if this is a noob question, but I didn't find it by a quick look at the docs. Gawaon (talk) 06:43, 30 April 2025 (UTC)- It doesn't handle it, and in those cases the reflist tag should be left in place. Though as far as I know one would never use the columns parameter with refs=, so it would be out of scope of this proposal. Mike Christie (talk - contribs - library) 11:33, 30 April 2025 (UTC)
- That's not entirely correct.
<references />
and{{reflist}}
both use 30em columns when there are more than 10 refs. This can be disabled with<references responsive=0 />
and{{reflist|1}}
. OTOH, reflist has more options:{{reflist|2}}
and{{reflist|30em}}
do columns without the "more than 10 refs" condition, and other widths besides 30em can be passed to{{reflist}}
too. Anomie⚔ 11:45, 30 April 2025 (UTC)- This (having multiple columns without using the template) was implemented in 2017. WhatamIdoing (talk) 17:11, 30 April 2025 (UTC)
- Including widths besides 30em? Aaron Liu (talk) 17:23, 30 April 2025 (UTC)
- Aaron, I don't know the answer to your question (regardless of whether your question is a "When was widths besides 30em added?" or "Was support for widths besides the site-defined default ever added?"), but I wonder whether it matters in practice. I've never seen someone combining narrower column widths with LDR, because {{sfn}} is the main use case for narrower column widths, and those aren't put into LDR. Nobody's talking about an absolute requirement to do this without exception. A bot/AWB script that's capable of detecting whether an article is using LDR could trivially be programmed to leave it alone if other parameters are being used. WhatamIdoing (talk) 19:24, 30 April 2025 (UTC)
- Including widths besides 30em? Aaron Liu (talk) 17:23, 30 April 2025 (UTC)
- This (having multiple columns without using the template) was implemented in 2017. WhatamIdoing (talk) 17:11, 30 April 2025 (UTC)
- That's not entirely correct.
- It doesn't handle it, and in those cases the reflist tag should be left in place. Though as far as I know one would never use the columns parameter with refs=, so it would be out of scope of this proposal. Mike Christie (talk - contribs - library) 11:33, 30 April 2025 (UTC)
- What about
{{reflist-talk|refs=}}
? --Shmuel (Seymour J.) Metz Username:Chatul (talk) 08:26, 30 April 2025 (UTC)
Since I think this would be a very controversial and thorny RFC if proposed, I've started a proposal below for discussion. Dan Leonard (talk • contribs) 02:52, 30 April 2025 (UTC)
Discussion of proposal re deprecate {{reflist|refs= in favor of <references>?
[edit]- Some parts of the proposal above are impossible to read in dark mode because they have white text on white background. See mw:Recommendations for night mode compatibility on Wikimedia wikis for suggested fixes. -- Beland (talk) 10:07, 30 April 2025 (UTC)
- This has been fixed; thanks! -- Beland (talk) 17:47, 30 May 2025 (UTC)
- What's the point of this proposal? I doubt it has more than a snowball in hell's chance of making it due to the flexibility of {{reflist}} to be used with or without a colwidth parameter making it too useful to give up without a good reason (which doesn't seem to exist), and spurious RfCs are a waste of editors' time. Why not rather focus on the original idea of deprecating the use of {{reflist}} with refs=, which seems to be the only actual problem anyway? Gawaon (talk) 11:50, 30 April 2025 (UTC)
- I don't see how specifying per-article column widths is that useful. Aaron Liu (talk) 12:32, 30 April 2025 (UTC)
- Well, following the recommendations in Template:Reflist, I tend to use the default setting when most references are "long" and there is no extra Bibliography section, while setting the colwidth to 20em for articles that use mostly short author–year references ({{sfn}} and friends) resolved in a Bibliography section. I also use 25em in articles that mix both styles more or less evenly. It's not essential, but it gives articles a nicer look. Gawaon (talk) 13:01, 30 April 2025 (UTC)
- Hmm, that does makes sense. Would a template that just applies a pre-set column width of either 20em or 25em on the
<references/>
fix that? Would not be hard to script if it just applies 20em or 25em every time, though it wouldn't support user-specified custom column widths. Aaron Liu (talk) 13:14, 30 April 2025 (UTC)- Well it's in any case slightly more annoying and less intuitive to replace
<references/>
with a template than just adding or modifying a parameter to an existing template. Plus the idea of getting rid of {{reflist}} in favour of a tag is a solution looking for a problem, as far as I can tell. Hence I doubt it's going to fly. Gawaon (talk) 13:50, 30 April 2025 (UTC)solution looking for a problem
the real problems with the template are listed above. {{reflist}} was created specifically to extend the parser tag and met very similar opposition fifteen years ago, it's worth considering now whether it's still needed in most cases. Dan Leonard (talk • contribs) 14:30, 30 April 2025 (UTC)- I'm not saying that, I'm saying something like this:Aaron Liu (talk) 15:28, 30 April 2025 (UTC)
==References== {{thincols}} <references />
- @Aaron Liu, the Visual Editor wouldn't be able to handle that due to a different limitation. Try editing pages with the VE that use {{refbegin}} & {{refend}} for a list of full citations. Rjjiii (talk) 00:34, 2 May 2025 (UTC)
- There's no
<references />
under refbegin, though. What I propose is just CSS templatestyles—it doesn't even change the DOM. There's no way it would break VisualEditor unless VE uses computer vision. Aaron Liu (talk) 00:56, 2 May 2025 (UTC)- But to get the CSS to apply, won't you have to wrap the <references> with a div or some other element? Rjjiii (talk) 01:35, 2 May 2025 (UTC)
- No. It's done through a stylesheet that will apply to all invocations of
<references />
on the entire page. You're thinking inline styles. Aaron Liu (talk) 01:41, 2 May 2025 (UTC)- TemplateStyles can affect classes like
reflist
andreference-text
? Rjjiii (talk) 02:01, 2 May 2025 (UTC)- Yes. Just put the inline style you mentioned below into a selector for those classes. Demonstrated at User:Aaron Liu/sandbox#References using User:Aaron Liu/Refwidth using Template:TemplateStyles sandbox/Aaron Liu/refwidth-20em.css. Aaron Liu (talk) 11:38, 2 May 2025 (UTC)
- Wow, this is a really cool development and completely changes the whole proposal. I had no idea TemplateStyles was this powerful. Dan Leonard (talk • contribs) 17:05, 2 May 2025 (UTC)
- Yes. Just put the inline style you mentioned below into a selector for those classes. Demonstrated at User:Aaron Liu/sandbox#References using User:Aaron Liu/Refwidth using Template:TemplateStyles sandbox/Aaron Liu/refwidth-20em.css. Aaron Liu (talk) 11:38, 2 May 2025 (UTC)
- @Aaron Liu, I was mistaken; I just assumed they did not work that way. I tested something similar out in {{refbegin/sandbox}}. The first real issue I see is that they both do something to the effect of
style="column-width:{{{any value}}}"
which I don't think can be done with separate CSS. The first workaround that comes to mind is to create CSS classes for each width and maybe round the values down (so that 22em becomes 20em) to avoid having too massive a number. That still seems kind of wonky though Rjjiii (talk) 03:17, 2 May 2025 (UTC) - @Aaron Liu, okay I did this in a way that feels goofy but seems to work? Check out this sandbox version of Open-source license in the VisualEditor. You should be able to see, edit, add, remove, and replace all references without any issues. You will not any styling affects unless you save the page. Regardless of changes to {{reflist}}, I may propose some version of this for {{refbegin}}. I think reflist deprecation may get limited traction though, because even without the template, the VE can't add or remove a LDR. Rjjiii (talk) 07:21, 2 May 2025 (UTC)
- TemplateStyles can affect classes like
- No. It's done through a stylesheet that will apply to all invocations of
- But to get the CSS to apply, won't you have to wrap the <references> with a div or some other element? Rjjiii (talk) 01:35, 2 May 2025 (UTC)
- There's no
- @Aaron Liu, the Visual Editor wouldn't be able to handle that due to a different limitation. Try editing pages with the VE that use {{refbegin}} & {{refend}} for a list of full citations. Rjjiii (talk) 00:34, 2 May 2025 (UTC)
- Well it's in any case slightly more annoying and less intuitive to replace
- This proposal specifically exempts uses of the template where editors feel a need for specific column widths. Many, if not the majority, of our articles use the default (blank or 30em) parameters.
<references>
now supports 30em columns as the default, so there's no difference between it and the template's default setting. Dan Leonard (talk • contribs) 14:32, 30 April 2025 (UTC)
- Hmm, that does makes sense. Would a template that just applies a pre-set column width of either 20em or 25em on the
- Well, following the recommendations in Template:Reflist, I tend to use the default setting when most references are "long" and there is no extra Bibliography section, while setting the colwidth to 20em for articles that use mostly short author–year references ({{sfn}} and friends) resolved in a Bibliography section. I also use 25em in articles that mix both styles more or less evenly. It's not essential, but it gives articles a nicer look. Gawaon (talk) 13:01, 30 April 2025 (UTC)
- I don't see how specifying per-article column widths is that useful. Aaron Liu (talk) 12:32, 30 April 2025 (UTC)
- As a purely practical measure, I suggest updating Help:List-defined references first. Also, we can probably get numbers on how commonly the visual editor is used here. The total was over 25,000,000 edits a couple of years ago. WhatamIdoing (talk) 17:17, 30 April 2025 (UTC)
- I would strongly support this -- I use the visual editor and while I don't run into list-reference articles much, I wouldn't mind pasting in <references/> rather than {{reflist}} when I make an article. Every RfC gets "solution in search of a problem" comments, some more than others, but there definitely is a problem here to be solved. Mrfoogles (talk) 23:25, 3 May 2025 (UTC)
- (If you're in the visual editor, then you don't have to paste in that code. It's in the menu under
Insert > References list
.) WhatamIdoing (talk) 00:24, 4 May 2025 (UTC)
- (If you're in the visual editor, then you don't have to paste in that code. It's in the menu under
- Hi, I'm Johannes from Wikimedia Deutschland's Technical Wishes team. I noticed this discussion mentioned sub-referencing, the feature we are currently working on. Some thoughts on
{{reflist}}
and<references>
:- As far as I know one major reason for creating
{{reflist}}
was the desire to render reference lists in multiple columns. Some projects (e.g. itwiki [1]) decided to deprecate their local reflist equivalent when responsive reference lists got introduced to MediaWiki in 2017 [2]. The feature works for both inline reference lists (<references responsive />
) and list-defined references (<references responsive> ... </references>
). - We initially based sub-referencing (our upcoming MediaWiki feature for re-using references with different details) on list-defined references, but moved away from the initial concept because we haven't been able to make it work with templates like reflist in VisualEditor. The new approach for sub-referencing is primarily based on in-line references [3], to avoid issues for VisualEditor users. Using list-defined references and sub-referencing will still be possible, but leads to the existing issues for VE users when using
{{reflist}}
. - We've investigated the use of templates like reflist on several wikis and documented our findings in phab:T377043, perhaps it's useful for future discussions.
- --Johannes Richter (WMDE) (talk) 12:59, 9 May 2025 (UTC)
- I think it would be better if the references tag would automatically minimise vertical space. If you have an article which is essentially all short citations it's too sparse even on default two-column. Ifly6 (talk) 15:55, 9 May 2025 (UTC)
- I think one of the problems with LDR is for wikitext editors. Adding a sentence and a source requires two edits: the first to the ==Section== where the content belongs, and the second to the ==References== to add the source. WhatamIdoing (talk) 16:38, 9 May 2025 (UTC)
- For wikitext editors, I see it as a tradeoff; having to make two edits, versus having to pick out the references from the running text. For me, making the two edits is easier. Jc3s5h (talk) 17:20, 9 May 2025 (UTC)
- I exclusively edit wikitext and find LDR particularly suited to the task. LDR massively reduces clutter in the editing window and allows me to just work on the prose. The Visual Editor masks the content of
<ref>
tags regardless of the referencing style, but when I use wikitext and LDR I don't have to deal with templates and reference text filling up the window. Compare the wikitext of Sheetz–Wawa rivalry with Pope Leo XIV, for instance. I can easily discern the prose in the former but the latter is a complete mess. Having to make a second edit is trivial compared to the massive readability benefit. It's also analogous to writing scholarly papers: I'd add a sentence to my paper and then separately go into my reference management software and add the reference. Dan Leonard (talk • contribs) 17:58, 9 May 2025 (UTC) - Agree with Leonard. Only reason I don't use it is I'm too lazy. It's not like it's super-hard to just edit the entire article or make the edit to /* References */ first. Aaron Liu (talk) 21:00, 9 May 2025 (UTC)
- As far as I know one major reason for creating
There has been insufficient discussion for a change of this magnitude in my opinion. To be more specific the question answered in the close was not the question asked, therefore people did not address that question. This change would require a full RFC at the very least. All the best: Rich Farmbrough 13:57, 4 June 2025 (UTC).
- Rich, do you mean that there was insufficient discussion to prefer "
<references>
" over "{{reflist|refs=
" (the consensus that was actually reached in the discussion), or do you mean that there was insufficient discussion to prefer normal/non-WP:LDR over occasionally using LDR (a possibility mooted early in the discussion that proved to be overkill, and so was abandoned in favor of a much smaller change that met the goal)? WhatamIdoing (talk) 21:10, 4 June 2025 (UTC)- This is consensus about a major decision, which probably requires a widely advertised RFC.
- The decision wasn't on the headline question.
- The decision is against the last 20+ years of moving from HTML markup to Wiki-markup.
- I'm not going to weigh in on the argument itself, I might even support it, but reintroducing <<references>, except as a temporary patch will add more confusion to wiki-source.
- All the best: Rich Farmbrough 18:24, 10 June 2025 (UTC).
- Though
<references>
might look HTML-like, it's not actually HTML markup. Gawaon (talk) 18:32, 10 June 2025 (UTC)- The
<references/>
tag is exactly as HTML-like as the<ref>
tags themselves. I am doubtful that it will cause significant confusion, and even if it is unfamiliar to someone, I think they'll figure it out as easily as they figure out the use of {{sfn}} instead of ref tags. WhatamIdoing (talk) 02:33, 11 June 2025 (UTC)
- The
- It was in the subheading and made up at least three quarters of the discussion. Even if there was a problem with that, I find it frivolously WP:Buro if we needed to have this extensive discussion on the appropriate forum be re-done in the even–more–time-consuming form of the RfC. Especially when I don't see anyone—who had a glance at the top-level ToC thanks to the unrelated Cent-listed discussion below—not interested to weigh-in on discouraging list-defined references (as mentioned in the h2 headline) yet interested by deprecating {{reflist|refs= (a feature only affecting list-defined references). Aaron Liu (talk) 01:00, 11 June 2025 (UTC)
- Though
- The solution that ultimately found consensus was proposed early on under the title "New proposal: deprecate
{{reflist|refs=
in favor of<references>
?" and it was discussed extensively, so this outcome seems fine and fair to me. Gawaon (talk) 07:28, 5 June 2025 (UTC)
Really? Maybe long, long, ago, but isn't now the consensus that citation templates use is best practice? Semi-random ping to @SandyGeorgia - are modern FAs allowed to have no citation templates? Piotrus at Hanyang| reply here 05:53, 1 April 2025 (UTC)
- I prefer citation templates, and I don't know if the requirements at FA are different, but text based references are still somewhat commonly used. -- LCU ActivelyDisinterested «@» °∆t° 08:31, 1 April 2025 (UTC)
- The lack of a uniform citation style is the most glaring style problem in Wikipedia. What we permitted years ago to encourage the expansion of the encyclopedia under the banner of "everyone can edit" now makes us look embarrassingly amateur. We should decide on a preferred style and make plans, with the help of intelligent bots, for adopting it universally in the long term. Zerotalk 10:27, 1 April 2025 (UTC)
- I have used citation templates exclusively for years, so yeah, so I will support anything that moves WP to more use of templates. A plan to gradually adopt templates as the standard for citatons is more likely to reach consensus. Donald Albury 14:29, 1 April 2025 (UTC)
- I would also support a default for switching to CS1 citation templates with default short citation formas in {{sfn}} – imo {{rp}} is just bad – with explicit proviso that custom anchors are permitted. Custom anchors are needed to deal with sources that don't have years (eg
Suetonius, Augustus
) as is common in classical studies. They can similarly can be used if an article benefits from shortened anchors (egCAH2 9
) or general short cites by title. - One of the huge benefits of the {{sfn}} "ecosystem" is the ability to produce full listings of missing anchors and sources. You simply can't do this with the text-based anchors. A text version of the citation
Smith 2000, § 3.14
with no corresponding bibliographic entry for Smith 2000 is nonsense and we really need ways to track this automatically. Then we can actually go and solve those problems. Though, for some certain self-contained corpuses of citations this can be unnecessary. EgPlutarch, Marius
is evident by convention. A tag here is useful mostly for people who don't know that convention and I usually try to provide it for such sources cited more than once or if translated.Ifly6 (talk) 15:17, 1 April 2025 (UTC) - We should consider the new parameter, details, being developed for the <ref> tag, currently under development. See my example on the Beta-Cluster. Also see m:Talk:WMDE Technical Wishes/Sub-referencing#Request for feedback. If successful, this could eliminate the need for {{sfn}} and its ilk. (For the Beta Cluster you might have to sign up for an account. Also, it isn't always working.) I am not a developer; maybe one of these days they will officially designate me as a pest. Jc3s5h (talk) 15:46, 1 April 2025 (UTC)
- That seems a bit restrictive in terms of narrative footnotes which say something like
Gruen 1995, p. 123, however notes that Dio, 3.14.15, contradicts the narrative in Suetonius, Julius, 1.2.3
orBut see Woodman 2021 for alternative views on blah blah
. While {{sfn}} is somewhat inherently restrictive, ref + {{harvnb}} essentially solves. One of the developers notes that those notes automatically merge, though, which is a must-have. I'm also not a huge fan of the anchors; imo anchors should match display text. Ifly6 (talk) 15:53, 1 April 2025 (UTC)- I'm afraid a talk page is not the right medium for Ifly6 to convey their point. Jc3s5h (talk) 15:57, 1 April 2025 (UTC)
- That seems a bit restrictive in terms of narrative footnotes which say something like
- I would strongly oppose any push to require citation templates, because (1) the citation templates more and more over the years have been pushed into a rigid format that makes it very difficult for human editors to edit by hand and get right, (2) this rigid format makes it frequent that what you want to cite does not fit into that format and should not be distorted to make it fit, and (3) we have bots running rampant over our articles repeatedly massaging templated citations into what they think is the corrected version of the same citation, but the bots often misunderstand citations (especially when the citation is to a review of another citation or to a reprint of another citation) and formatting a difficult citation manually can be a deliberate defense against those bots. —David Eppstein (talk) 16:23, 1 April 2025 (UTC)
- Can you show an example of this for illustration? Ifly6 (talk) 16:36, 1 April 2025 (UTC)
- Just trawl through the history of User talk:Citation bot and you will find many errors of these types. Often they get fixed, meaning that the exact circumstances that caused this behavior will not immediately trigger the same error. This does not fix the general issue. (The same issue extends to gnomes as well as bots; I had to today revert a gnome who tried to insert repeated fake titles on a collection of book reviews that had no title and were properly formatted using citation templates using title=none, presumably because that parameter value lists the article in CS1 maint: untitled periodical. Manually formatting the book reviews would have avoided that problem and in part because of that I have been manually formatting book reviews more often recently.) —David Eppstein (talk) 23:29, 1 April 2025 (UTC)
- Making a {{cite book review}} would help bots and people distinguish between an author incorrectly being put in the title vs. the name of the author being reviewed being part of a correct title. Using a template like that would make it easier for downstream machine consumers (like sites that aggregate references to a work or an author across many sources) to parse these weird cases as well.
- I expect most people prefer to use HTML forms or wizards to make citations rather than raw wikitext, unlike us long-time editors. It is difficult to implement that without machine-writable templates. If templates don't support pretty much the full universe of cases, then we're discouraging a lot of editors from properly citing their work, so we should make an effort to flesh them out. Personally, I find it's a big pain to remember what punctuation to use where; it's much easier to use templates that tidy up after me. It also would be soooo much easier to change the output later across millions of pages if consensus changes about the punctuation and formatting.
- -- Beland (talk) 09:43, 30 April 2025 (UTC)
- Just trawl through the history of User talk:Citation bot and you will find many errors of these types. Often they get fixed, meaning that the exact circumstances that caused this behavior will not immediately trigger the same error. This does not fix the general issue. (The same issue extends to gnomes as well as bots; I had to today revert a gnome who tried to insert repeated fake titles on a collection of book reviews that had no title and were properly formatted using citation templates using title=none, presumably because that parameter value lists the article in CS1 maint: untitled periodical. Manually formatting the book reviews would have avoided that problem and in part because of that I have been manually formatting book reviews more often recently.) —David Eppstein (talk) 23:29, 1 April 2025 (UTC)
- Can you show an example of this for illustration? Ifly6 (talk) 16:36, 1 April 2025 (UTC)
- The current status is one may follow a printed style manual (like The Chicago Manual of Style (CMOS), and other editors will respect that choice. (Actually respect, not just tolerate). If an editor makes up a style just for a certain article, theoretically it's allowable, but in practice other editors can't follow it because they can't read the original editor's mind. The nearest thing we have to a style manual for citation templates is Help:Citation Style 1, but it has problems.
- It doesn't purport to be complete. On many points it defers to the style in a particular article, such as sentence case or title case for titles of works cited, giving full first names for authors or just initials, etc.. It is only 25 pages long when exported to PDF, compared to 177 pages for the relevant chapters in CMOS 18th ed.
- There is no policy that the implementation of the citation templates follow the documentation. If a graduate student at a US university submitted a paper that was required to follow a published style manual, but the citation software used by the student flagrantly deviated from the manual, the student would fail the course. In Wikipedia, some comments would be put on some talk pages and nothing would happen.
- It is absolutely fundamental that a reliable source should never be disqualified because there isn't a citation template to support it. Hand-written citations must always be allowed in this case. But there is no manual to follow when writing such a citation.
- Since 2020 parenthetical referencing has been deprecated on Wikipedia. As a result, the only acceptable remaining style is endnotes. Respectable published style guides that recommend endnotes or footnotes separate citation elements with the comma, as in "James II of England". But most Wikipedia articles separate them with periods, as in "Nato phonetic alphabet". This should be fixed.
- Jc3s5h (talk) 16:27, 1 April 2025 (UTC)
- If we want to change the "neither encouraged nor discouraged", then we probably need an RFC.
- I suggest keeping it simple and focused. For example, despite what @Ifly6 says, mentioning {{sfn}} will provoke opposition (because it is not used in ~98% of articles and is not wanted in subject areas that rely primarily on short articles instead of books/sources that need to give specific page numbers), and it is largely irrelevant, so it shouldn't be mentioned.
- The simplest is probably to use the "change X to Y" format. For example:
- Should we change "neither encouraged nor discouraged" to "gently encouraged but not required"?
- Should we change "neither encouraged nor discouraged" to "preferred but not mandated"?
- Should we change "neither encouraged nor discouraged" to "by far the most popular choice, but not required"?
- I have, in other areas (e.g., MOS:APPENDIX), had good success with declaring a given option to be "popular" rather than "preferred". Editors tend to choose the popular/normal/usual approach. WhatamIdoing (talk) 17:00, 1 April 2025 (UTC)
- When wording the RFC, keep in mind that if it succeeds, some editors will try to interpret the new wording as license to change articles to citation templates without seeking consensus, just as one may now change an article from parenthetical referencing to endnotes without seeking consensus. Jc3s5h (talk) 17:14, 1 April 2025 (UTC)
- Perhaps the entire WP:TEMPLATEREFS sentence (or even the whole/short paragraph) should be in the RFC. The specific sentence currently says: The use of citation templates is neither encouraged nor discouraged: an article should not be switched between templated and non-templated citations without good reason and consensus – see "Variation in citation methods", above.
- That could be changed to something like "The use of citation templates is popular, though not required. However, an article that predominantly uses a non-templated style should not be switched without prior discussion – see "Variation in citation methods", above" (example text only; write whatever you think would be helpful). WhatamIdoing (talk) 17:39, 1 April 2025 (UTC)
- When wording the RFC, keep in mind that if it succeeds, some editors will try to interpret the new wording as license to change articles to citation templates without seeking consensus, just as one may now change an article from parenthetical referencing to endnotes without seeking consensus. Jc3s5h (talk) 17:14, 1 April 2025 (UTC)
- (1): I don't see much ambiguity about when to use sentence vs. title case; the CS1 page has guidance for which fields use which. For the "first initial vs. first name" question, it seems to me we should always put the full name, unless only the initial is available, for disambiguation purposes - especially given that Wikipedia citations have machine consumers that correlate authors. Are there only a few remaining questions we could easily answer? Or would we want to pick the third-party style guide closest to general Wikipedia practice as a default? Or provide a short list of third-party guides and let articles pick one?
- (2): Isn't it common sense that if a template does not match its documentation (or the MOS), one or the other should be changed? Making that common sense into a policy wouldn't magically summon volunteer labor to do the implementation work.
- (3): If we decided to go full-template, presumably if there are situations not covered we'd add parameters or additional templates. Situations not covered in the meantime would simply remain non-compliant. We could, if we wanted, designate a third-party style guide as a default or allow an article to choose from a short list of popular third-party styles.
- (4): I think what you are describing is Citation Style 2? I would support merging these two styles so that there is more site-wide consistency, but I have no opinion as to the most "respectable" punctuation. -- Beland (talk) 09:25, 30 April 2025 (UTC)
- FAs are allowed to have any consistent citation style, whether produced by templates or handwritten. Nikkimaria (talk) 00:34, 2 April 2025 (UTC)
- Pinged here ... agree with Nikkimaria. I don't see a need for any change; not broken, doesn't need fixing. SandyGeorgia (Talk) 01:32, 2 April 2025 (UTC)
- I would support changing guidance to say templates are "preferred" and letting people change articles to use them without any further discussion. This makes formatting more consistent because there's less room to be sloppy, automates the process of finding some incomplete or bogus citations, makes it possible to write user-friendly GUI tools that hide the raw wikitext, significantly simplifies the parsing downstream consumers have to do thanks to COinS (e.g. citation aggregation sites, author profile builders, archive.org). Clarifying badly-formatted citations will probably help with the enormous task of fact-checking all our content. This process will probably also shake out some citation styles that should not be used on Wikipedia because they are so radically different from what is done on the rest of the site. And maybe one or two we want to keep but give them their own templates. -- Beland (talk) 10:01, 30 April 2025 (UTC)
- Does the community actually want to be "letting people change articles to use them without any further discussion"? WhatamIdoing (talk) 18:32, 30 April 2025 (UTC)
- I would support doing an RFC to find out. I often do so for one or a handful of citations at a time, and I don't remember anyone reverting that on the grounds the article doesn't use a template-compatible citation style. (I do remember some confusion about how to cite web pages that are only accessible from archive.org.) Often I'm switching to templates because they handle square brackets in titles without awkward escaping. -- Beland (talk) 19:26, 30 April 2025 (UTC)
- I suggested a couple of possible alternative wordings above. Do any of those appeal to you? WhatamIdoing (talk) 19:30, 30 April 2025 (UTC)
- I would go for the full throated version - change "neither encouraged nor discouraged" to "preferred", not "preferred but not mandated" or the other suggestions which seem to leave a lot of wiggle room for arguments to break out. -- Beland (talk) 19:42, 30 April 2025 (UTC)
- I realized another benefit of going full template - just as we have the ability to set "mode=cs2" once for an entire article, we could add "mode=chicago" or "mode=mla" or whatever alternative styles the community can't bear to part with. This would let us change styles for an article very easily (except perhaps if downcasing is needed?) if consensus changes about which articles need which style, and it would also strongly enforce per-article consistency without forcing any particular citation style. I like the idea of having a short list of approved styles, because readers encountering a very rare citation style are likely to be confused or maybe assume it's the result of sloppiness. The fewer citation modes the better in my opinion, but this might be a compromise of the sort you're looking for in order to widen support. -- Beland (talk) 19:48, 30 April 2025 (UTC)
- All I can say is that if we go “full template”, I will no longer be able to contribute to Wikipedia. Perhaps I am too old. I still think in terms of sentences and paragraphs, not data parameters and fields. I never learned how to use templates, and don’t really have any interest in learning now. I still format citations by hand. I am fine with others following along after me and inputting my citations into a template, but I’m never going to create a new citation using one. Oh well… time to catch the early bird special at the Golden Corral and then go watch Matlock. Blueboar (talk) 20:25, 30 April 2025 (UTC)
- @Blueboar:
All I can say is that if we go “full template”, I will no longer be able to contribute to Wikipedia.
You appear to be assuming that you'd have to type these templates out by hand, which has never been true. Polygnotus (talk) 01:44, 2 May 2025 (UTC) - There's no reason for you to quit Wikipedia; even if the MOS says templates are preferred, I (and I hope all other editors) will be happy to accept your hand-formatted citations, and leave converting them to templates to a wikignome. -- Beland (talk) 20:55, 30 April 2025 (UTC)
- I've inquired about the prevalence of citation templates at Wikipedia:Village pump (technical)#Prevalence of citation templates, and it looks like ~80% of articles use the main citation templates.
- I hope that if the community decided to officially "prefer" citation templates, they would also choose to reiterate the main behavioral goal: While you should try to write citations correctly, what matters most is that you provide enough information to identify the source. Others will improve the formatting if needed. Or, to put it more simply, do your best. Nobody should get hassled about how they format a citation so long as (a) we have enough information to identify the source and (b) they don't revert if someone comes along after to "fix" it. WhatamIdoing (talk) 23:20, 30 April 2025 (UTC)
- If the community decides to officially "prefer" citation templates, it should only do so at a time when the citation templates are capable of fully formatting all citations. That time is not now; the citation templates are too inflexible, and too prone to raising errors in common use cases (such as that we wish to cite the original publication of a book source but include the isbn of a reprinted copy of the same book). —David Eppstein (talk) 00:17, 1 May 2025 (UTC)
- Isn't that already possible? There's no validation of ISBNs, but you could always do {{cite book |title=Original book |year=1901}} etc. for the original copy, followed by a separate {{ISBN|1234567890}} if you wanted to keep them apart. WhatamIdoing (talk) 00:39, 1 May 2025 (UTC)
- If the community decides to officially "prefer" citation templates, it should only do so at a time when the citation templates are capable of fully formatting all citations. That time is not now; the citation templates are too inflexible, and too prone to raising errors in common use cases (such as that we wish to cite the original publication of a book source but include the isbn of a reprinted copy of the same book). —David Eppstein (talk) 00:17, 1 May 2025 (UTC)
- @Blueboar Few thoughts (speaking as someone who remembers time before the Internet, too...). First, I'd expect that "old geezers" from my and older generations are familiar with forms to be filled in. Templates are just that. I don't think filling in a form takes longer than writing a citation by hand. (I am assuming, of course, the use of VE or such, doing this by typing the code is painful, please don't). Second. Templates enable various uses of metadata. They make citations better just like hyperlinks makes text better, or computers enable Wikipedia. They are a step in the right direction. That third, my third point - frankly, conversion of citations from free flowing whatever written format into templates is something that AIs should be able to handle. I don't know when we will have a bot or gadget for that, but just run ChatGPT or such in a window where you run a task telling it to turn it into Wikipedia citation template code, and voila, you should get a well formatted code to paste back into wiki in a second. So, errr, there's no need to leave or such. Learning how to use the better system (and yes, because of metadata, it is strictly better, no ifs and buts) in this case is not hard - just fill in a simple form, or have AI give you a code. Look, I understand the issues (annoyances) of unfriendly new interfaces well, but in this case, it's easy to move from old, inferior output to the new, superior one. Really. Try it. Piotrus at Hanyang| reply here 04:47, 2 May 2025 (UTC)
- Forms work great for a database… not an encyclopedia. Blueboar (talk) 12:13, 2 May 2025 (UTC)
- Huh? They work perfectly fine for me and all others who use VE, or tools like TWINKLE... Piotrus at Hanyang| reply here 13:25, 5 May 2025 (UTC)
- Forms work great for a database… not an encyclopedia. Blueboar (talk) 12:13, 2 May 2025 (UTC)
- @Blueboar:
- There have been similar entertainings regarding other styles in the CS1 module (MLA and Vancouver particularly), and they've either just gotten nowhere or I suspect more commonly were not friendly to integrate with the current structure of the module set and so were given up on. Were something like this to be done, I suppose it would be possible to place them in their own modules and then call those only when a certain parameter is provided to the CS1 module, but even today there are some checks that CS1 makes very early in the execution of the module which may be inapplicable in other older/recognized citation styles. So you might as well start your own module. Module:Cite LSA used to exist as one attempt at this, and there are a few Bluebook style citation templates that have a bare minimum of centralization. For what code sharing might be possible because arbitrary style does ask for a review, I've mused before on the CS1 help talk page, but I suspect those have gone nowhere for time and little or no known potential users. (For example, the ID and access date checking that CS1 does. Of course, then we're imposing some burden both on CS1 and external users of CS1, primarily at our sister and sister language wikis.) Izno (talk) 23:04, 30 April 2025 (UTC)
- All I can say is that if we go “full template”, I will no longer be able to contribute to Wikipedia. Perhaps I am too old. I still think in terms of sentences and paragraphs, not data parameters and fields. I never learned how to use templates, and don’t really have any interest in learning now. I still format citations by hand. I am fine with others following along after me and inputting my citations into a template, but I’m never going to create a new citation using one. Oh well… time to catch the early bird special at the Golden Corral and then go watch Matlock. Blueboar (talk) 20:25, 30 April 2025 (UTC)
- I realized another benefit of going full template - just as we have the ability to set "mode=cs2" once for an entire article, we could add "mode=chicago" or "mode=mla" or whatever alternative styles the community can't bear to part with. This would let us change styles for an article very easily (except perhaps if downcasing is needed?) if consensus changes about which articles need which style, and it would also strongly enforce per-article consistency without forcing any particular citation style. I like the idea of having a short list of approved styles, because readers encountering a very rare citation style are likely to be confused or maybe assume it's the result of sloppiness. The fewer citation modes the better in my opinion, but this might be a compromise of the sort you're looking for in order to widen support. -- Beland (talk) 19:48, 30 April 2025 (UTC)
- I would go for the full throated version - change "neither encouraged nor discouraged" to "preferred", not "preferred but not mandated" or the other suggestions which seem to leave a lot of wiggle room for arguments to break out. -- Beland (talk) 19:42, 30 April 2025 (UTC)
- I suggested a couple of possible alternative wordings above. Do any of those appeal to you? WhatamIdoing (talk) 19:30, 30 April 2025 (UTC)
- I would support doing an RFC to find out. I often do so for one or a handful of citations at a time, and I don't remember anyone reverting that on the grounds the article doesn't use a template-compatible citation style. (I do remember some confusion about how to cite web pages that are only accessible from archive.org.) Often I'm switching to templates because they handle square brackets in titles without awkward escaping. -- Beland (talk) 19:26, 30 April 2025 (UTC)
- Does the community actually want to be "letting people change articles to use them without any further discussion"? WhatamIdoing (talk) 18:32, 30 April 2025 (UTC)
@David Eppstein: you mentioned above that the current set of citation templates are not ready to be preferred because not all works can be cited with these templates. It seems to me they're really not ready for use at all, because at any time a need to add a new citation to an existing article that already has a long list of citations, but no existing template is suitable for the work to be added. The problem is all the existing template documentation is focused on which template to use, and how to set the parameters. It's hard to find examples of how citations should look when they are rendered; any such examples are scattered and disorganized in the documentation.
If proper documentation existed, an editor who had to add a citation for something that isn't supported by any existing template could decide which template is the closest fit, and hand-write a template that generally resembles one of the existing templates. Jc3s5h (talk) 01:05, 1 May 2025 (UTC)
- It's a fair point that existing templates don't handle all use cases, but that may be because there is no guideline pushing people to use them in all cases. My expectation if templates are "preferred" would be that unhandled cases would be left hand-written until someone created a template to handle them. Based on this feedback, maybe we need to say that explicitly. How about:
- The use of citation templates is preferred for situations the templates are designed to handle. Templates should be expanded or created to cover the remaining situations that would otherwise need to be manually formatted.
- "Situations" might include the need to support rare citation styles, though I hope this is not the case. I see templates supporting CS1, CS2, Vancouver, Bluebook, and Harvard. Do we know of any articles that consistently use a style that is not one of these?
- I don't see why extensive documentation is needed, though some basic points are helpful. But if you need to create a new template and you want to see how e.g. the CS1 templates render something close to your use case, just plug the relevant parameters into a template and preview it or put a copy in your sandbox. Adding too much documentation increases the risk that the code and the documentation get out of sync, which will not help someone trying to expand the system.
- In any case, I think the existing templates cover 80-90% of what is needed, and I'm sure we have plenty of work converting those to keep us busy while template builders expand support. -- Beland (talk) 02:23, 1 May 2025 (UTC)
- There are plenty of FA-level articles that use nontemplated styles. Many people who do scholarly work off-wiki can comfortably format citations consistently by hand, so I don't know why we would do "plenty of work" to change them. And it's trivially easy to create inconsistently formatted citations using templates. Nikkimaria (talk) 02:47, 1 May 2025 (UTC)
- Those scholars can continue to contribute hand-formatted citations, and if you don't want to do any work on this, you don't have to. A good reason to change them is that they are not emitting COinS metadata, and thus are slightly less useful to downstream consumers. It's easier for scripts to validate the contents of individual fields than it is to make sure that all the punctuation and italics and everything in a hand-formatted citation is done correctly. I mean, how would a script be able to tell the difference between a chapter in a book and an article in a journal if the formatting can't be trusted because it's what's being checked? Featured articles are about 0.1% of the overall encyclopedia. The fact that they're nice and tidy should be celebrated, but that doesn't obviate the problem of the millions of untidy articles. -- Beland (talk) 08:18, 1 May 2025 (UTC)
- I personally think that millions of articles looking untidy is a feature, not a bug. What a focus on compliance with the MoS even for poorly written articles that cite unreliable sources does is put a huge amount of precisely defined lipstick on pigs. Unifying the citation style of articles should not be done before checking the actual content of the citations. —Kusma (talk) 08:42, 1 May 2025 (UTC)
- I see your point, and I do actually use poor formatting as a proxy to automatically identify articles with dubious content, though that's usually a pile of unreferenced strings. But it would be awkward to try to preserve this potential signal as long as possible by making a rule that wikignomes aren't allowed to clean up spelling, punctuation, citation formatting, etc. without verifying the claims being made in the prose they are tidying and that the sources are cited accurately. Often that happens naturally, and it's easy to catch glaring problems when doing that, but fact-checking takes so much longer than tidying up, it lags by decades. We also don't have a way of checking which passages have already been fact-checked, which would lead to a lot of redundant work. At the very least I do tag prose I've just made from a pile of dubiousness into a clean, grammatical flow as needing citations if it doesn't have any.
- The Guild of Copy Editors does actually reject unreferenced passages; these do tend to change a lot when the first sources are added, which is extremely healthy. But after that, as soon as someone has put in enough effort to make plausible footnotes, the text is considered stable enough to deserve tidying.
- If I had to guess, I'd say we have greater problems with claims not matching cited sources with mature citations rather than when the citation is first added. People tend to edit article prose without verifying that the new claim is still supported by the footnote at the end of the sentence, and sometimes sentences get combined or split and footnotes wander around. -- Beland (talk) 09:38, 1 May 2025 (UTC)
- I personally think that millions of articles looking untidy is a feature, not a bug. What a focus on compliance with the MoS even for poorly written articles that cite unreliable sources does is put a huge amount of precisely defined lipstick on pigs. Unifying the citation style of articles should not be done before checking the actual content of the citations. —Kusma (talk) 08:42, 1 May 2025 (UTC)
- Those scholars can continue to contribute hand-formatted citations, and if you don't want to do any work on this, you don't have to. A good reason to change them is that they are not emitting COinS metadata, and thus are slightly less useful to downstream consumers. It's easier for scripts to validate the contents of individual fields than it is to make sure that all the punctuation and italics and everything in a hand-formatted citation is done correctly. I mean, how would a script be able to tell the difference between a chapter in a book and an article in a journal if the formatting can't be trusted because it's what's being checked? Featured articles are about 0.1% of the overall encyclopedia. The fact that they're nice and tidy should be celebrated, but that doesn't obviate the problem of the millions of untidy articles. -- Beland (talk) 08:18, 1 May 2025 (UTC)
- There are plenty of FA-level articles that use nontemplated styles. Many people who do scholarly work off-wiki can comfortably format citations consistently by hand, so I don't know why we would do "plenty of work" to change them. And it's trivially easy to create inconsistently formatted citations using templates. Nikkimaria (talk) 02:47, 1 May 2025 (UTC)
- Jc3s5h, can you give me an example of a work for which "no existing template is suitable"? WhatamIdoing (talk) 02:58, 1 May 2025 (UTC)
- {{Cite map}} requires a title. Suppose a map doesn't have a title. Style guides typically say to give a description of the map where the title would usually go, but not use quote marks around the description, and not use italics, so readers can tell it's just a description. Jc3s5h (talk) 04:32, 1 May 2025 (UTC)
- @Trappist the monk, what would you recommend for a CS1 template that doesn't require a title when the work is untitled? WhatamIdoing (talk) 05:24, 1 May 2025 (UTC)
- Jumping in randomly here...my first thought would be we could add a "no-title-desc" parameter to {{cite map}}? I would also be tempted to put parens instead of quote marks like, (untitled map of Massachusetts Bay Colony) but perhaps this is not common practice in professional citations. I'm also wondering if this has actually come up or if this is speculative? Text works with no title (as used to be common practice) are named by the first few words; see MOS:INCIPIT. -- Beland (talk) 08:27, 1 May 2025 (UTC)
- cs1|2 journal templates support
|title=none
which suppresses the rendering of the article title. That was intended to be used for en.wiki articles that followed the citation tradition wherein the title of the cited article is not made part of the citation. I suspect that most if not all uses of|title=none
are not used to maintain that traditional substyle. - I once suggested that cs1|2 might support a
|description-in-lieu-of-title=
sort of parameter (in need of a better name) that would render an unstyled description in place of|title=
. That suggestion died aborning. - —Trappist the monk (talk) 13:30, 1 May 2025 (UTC)
- @Trappist the monk, are you sure about that? This: "none". doesn't look like suppressing the rendering of the article title to me. WhatamIdoing (talk) 20:55, 1 May 2025 (UTC)
cs1|2 journal templates support
|title=none
{{cite journal |title=none |journal=Journal}}
→ Journal.{{cite journal}}
: CS1 maint: untitled periodical (link)
- —Trappist the monk (talk) 21:27, 1 May 2025 (UTC)
- Perhaps that feature should be extended to {{cite map}} (or generally; there are webpages with no titles, too). WhatamIdoing (talk) 22:06, 1 May 2025 (UTC)
- Journal templates do not support title=none when there is a url present. In general, webpages are going to have urls and urls are going to block the citation templates from supporting title=none even if that support is extended to non-journal templates. —David Eppstein (talk) 22:28, 1 May 2025 (UTC)
- That makes sense because we need a title for the link.
- Not putting the title of the article being cited in the citation to the article...sounds crazy when I say it out loud? Is there an article with an example of this? -- Beland (talk) 01:10, 2 May 2025 (UTC)
- Sometimes there just isn't a title. Consider a sign: Maybe it will have a title, and maybe it won't. A letter is another source that often doesn't have a title. WhatamIdoing (talk) 01:39, 2 May 2025 (UTC)
- Sure, but a sign is not an journal article. What I'm scratching my head over is why a citation wouldn't have the title of a journal article when one exists. I feel like I need an example for context. -- Beland (talk) 02:46, 2 May 2025 (UTC)
- There's plenty of solutions for this, see Help talk:Citation Style 1/Archive 98#Handle title=none with url better.
- Why those aren't implemented is beyond me. Headbomb {t · c · p · b} 00:53, 7 May 2025 (UTC)
- Sometimes there just isn't a title. Consider a sign: Maybe it will have a title, and maybe it won't. A letter is another source that often doesn't have a title. WhatamIdoing (talk) 01:39, 2 May 2025 (UTC)
- Journal templates do not support title=none when there is a url present. In general, webpages are going to have urls and urls are going to block the citation templates from supporting title=none even if that support is extended to non-journal templates. —David Eppstein (talk) 22:28, 1 May 2025 (UTC)
- Perhaps that feature should be extended to {{cite map}} (or generally; there are webpages with no titles, too). WhatamIdoing (talk) 22:06, 1 May 2025 (UTC)
- @Trappist the monk, are you sure about that? This: "none". doesn't look like suppressing the rendering of the article title to me. WhatamIdoing (talk) 20:55, 1 May 2025 (UTC)
- @Trappist the monk, what would you recommend for a CS1 template that doesn't require a title when the work is untitled? WhatamIdoing (talk) 05:24, 1 May 2025 (UTC)
- Another example that I run into all the time is book reviews, which don't usually have titles, or are labeled with things formatted as titles that are not really titles like "Reviews - Euler’s gem, by David S. Richeson. Pp. 336. £16.95. 2008. ISBN 978 0 691 12677 7 (Princeton University Press)". When the review is published in a journal and has only a doi link, then the cite journal template can handle it with title=none, but most other formats of book reviews cannot be handled by the templates without making up a nonexistent and therefore false title. We should not be putting false information into the encyclopedia, not even in references and not even because the template doesn't work without it. And the bots that run around "improving" citations will often get confused by citations to reviews and mix them up with citations to the thing being reviewed or vice versa (an egregiously bad example from today: [4]). To avoid both problems I've taken to frequently formatting references to book reviews manually instead of with the templates. —David Eppstein (talk) 04:53, 1 May 2025 (UTC)
- It's unclear to me if the example you link to is a problem with the bot or the human operating it? It's also unclear to me what the thing being cited is. Is it a book or an article or a review of a book or ?
- If a journal publishes a book review just titled "War and Peace by Herman Melville" then I agree it might be confusing and arguably incorrect to put "title=Review of War and Peace by Herman Melville". It seems better to have output like:
- "[Review of] War and Peace by Herman Melville". Archimedes Syracuse.
- or
- "War and Peace by Herman Melville" (review by Archimedes Syracuse).
- or whatever the professional style guide specifies for these situations. It might be useful to have separate fields like "reviewed_title" and "reviewed_author" if we need to fabricate strings but make it clear they are not a word-for-word title the reader should be looking up. Or a separate template like {{cite review}} to take the same fields as e.g. {{cite journal}} but produce different output with "review" in there somewhere. -- Beland (talk) 08:50, 1 May 2025 (UTC)
- The example I link to was a perfectly good and perfectly normal citation to a book. Until Citation bot got to it. Citation bot somehow discovered the existence of a review of that book in the journal Nature and half-converted the citation into a Frankenstein citation half about the book and half about its review.
- It is useful to cite things that have reviews. It is also, separately, sometimes useful to cite the reviews of those things (for instance in articles about the things being reviewed). Many humans are capable of distinguishing which kind of citation is intended and keeping them distinct from each other. The bots have demonstrated themselves to be incapable of this. This bot misbehavior makes it problematic to have templated citations to reviews because the bots are likely to misinterpret them and break them. —David Eppstein (talk) 16:47, 1 May 2025 (UTC)
- Huh. I would expect citations to books to use {{cite book}}. Still unclear to me if there is a human review step that should have caught this? -- Beland (talk) 01:13, 2 May 2025 (UTC)
- If you're referring to the fact that the bot citation damage involved a {{citation}} template rather than a {{cite book}} template: that is one of the key differences between Citation Style 1 and Citation Style 2. In Citation Style 1 editors have to figure out which of many different citation templates to use and the automatic tools frequently get it wrong calling them all cite web. In Citation Style 2, everything uses one template, {{citation}}. The other difference is. That Citation Style 1. Has many periods. That break up. The flow. Of the citation. Citation Style 2 uses commas, instead.
- I'm surprised you wouldn't know this already. Am I misinterpreting your reply? —David Eppstein (talk) 07:46, 2 May 2025 (UTC)
- Either template can produce either output style with the "mode" parameter if the default output is not desired. I guess I'm just not in the habit of using {{citation}}; it seems a bit more vague, but of course it's not wrong to use it.
- That really wasn't the important part of my comment. Since no one was answering my question, I went ahead and tested the Fundamental theorem of calculus scenario. Citation bot does not give humans a chance to preview its changes before it makes them, it only gives them a link to the diff afterwords. Though in this case, even if I had manually checked the source, it's unclear I would have noticed that it was a review and not the original work. Both the bot and the humans can be confused because the review has all the same metadata as the original work (with the complication that two authors are usually mentioned rather than one). I can't think of a good way to distinguish the two automatically, so humans just need to look out for this. It's possible looking for key phrases on the page (in this case, "review" isn't used, but "Books Received" is) could be used as a trigger to put up a red flag for the human user. This isn't 100% reliable because e.g. "reviews" would also show up on literature review articles. It's also possible the review is in fact what is being cited, so it's not great to use as an automatic exclusion. For now, I have added a note to User:Citation bot flagging this for humans generally.
- The point of Citation bot is to provide readers with easier access to sources, gets get quite a bit of use, saves a lot of work, and works well in the vast majority of cases - so I would be reluctant to try to revoke its bot approval. Even this error will bring readers to a review of the source they are looking to read, which has a relatively straightforward recovery since they still have access to all the correct metadata once they realize what has happened.
- There is no need to use hand-formatted citations to prevent the bot from altering a citation. Its documentation shows how to exclude the bot from an entire page or from a single citation known to be problematic (I would prefer the latter for ease of long-term maintenance). -- Beland (talk) 22:04, 2 May 2025 (UTC)
- And then the people who maintain the bot go around removing these exclusions when they think they have fixed the very specific issue that caused the bot to misbehave once and be tagged for exclusion. But the problem is not specific bugs; it is that certain classes of issue require human understanding that the bot lacks. We have just this month had a Citation bot user blocked after an ANI thread because they thought the bot could be run without supervision and were blowing off complaints about the resulting bad edits. The bot is usually useful but occasionally causes problems, and needs checking. —David Eppstein (talk) 18:20, 3 May 2025 (UTC)
- I've not seen people removing nobot exclusions, but if they do, it could help to put in the exclusion comment what to check after removal. But people could just as easily go around switching hand formatted citations to templates and not know that the reason they were hand coded was bot danger, rather than simply laziness. It seems better to explicitly declare bot incompatibility than lay a trap of a secret workaround. -- Beland (talk) 01:50, 4 May 2025 (UTC)
- And then the people who maintain the bot go around removing these exclusions when they think they have fixed the very specific issue that caused the bot to misbehave once and be tagged for exclusion. But the problem is not specific bugs; it is that certain classes of issue require human understanding that the bot lacks. We have just this month had a Citation bot user blocked after an ANI thread because they thought the bot could be run without supervision and were blowing off complaints about the resulting bad edits. The bot is usually useful but occasionally causes problems, and needs checking. —David Eppstein (talk) 18:20, 3 May 2025 (UTC)
- Huh. I would expect citations to books to use {{cite book}}. Still unclear to me if there is a human review step that should have caught this? -- Beland (talk) 01:13, 2 May 2025 (UTC)
- {{Cite map}} requires a title. Suppose a map doesn't have a title. Style guides typically say to give a description of the map where the title would usually go, but not use quote marks around the description, and not use italics, so readers can tell it's just a description. Jc3s5h (talk) 04:32, 1 May 2025 (UTC)
I have started Wikipedia talk:Citing sources#RFC on preferring templates in citations. -- Beland (talk) 23:54, 6 May 2025 (UTC)
To what extent is a press release a reliable source? They are mentioned in passing in WP:RS, but I cannot track any direct comment on them.
In the case I have dealt with, I had excised comment on visitor numbers from Vasa (ship) with [5]. I have since seen statistics on museum visits in Sweden collated by a government agency ([6], table 23 in the spreadsheet). But the simplest "headline figure" that seems to encapsulate the number of visitors to the ship since her salvage is a Vasamuseet press release [7] giving a figure of 45 million to date. (Added with [8]) To my mind, this figure from the museum is validated by them having to report these numbers to a government agency. Simple arithmetic from the government agency report makes the 45 million entirely believable. For myself, I find the cited source totally sufficient. Clearly other press releases by other organisations may be different. In my specific example I have chosen not to contextualise the visitor numbers as "Scandinavia's most visited museum" which, I understand, is in their marketing material. I don't see marketing material as an RS, whilst a press release may well be.
I am wondering to what extent my decision-making is supportable by guidance on RSs. ThoughtIdRetired TIR 19:57, 25 April 2025 (UTC)
- A museum's press release wouldn't confer notability under WP:SIRS, but for confirming uncontroversial statistics like visitor numbers, there's no real reason to expect or need an independent source. The relevant section is WP:SELFSOURCE, where organizations' statements about themselves are acceptable in some cases. Your citation seems perfectly fine (although if you went with "most-visited museum" you might run afoul of the rule against unduly self-serving); after all, we have {{cite press release}} for this reason. Dan Leonard (talk • contribs) 19:17, 28 April 2025 (UTC)
- Press releases are always Wikipedia:Self-published sources. They are almost always Wikipedia:Primary sources. They are usually not Wikipedia:Independent sources.
- But: That doesn't mean they're WP:NOTGOODSOURCE. WhatamIdoing (talk) 19:29, 28 April 2025 (UTC)
I used the Template:Cite web for a webpage on the US Patent and Trademark Office's TSDR, and I was wondering whether there is a special way to cite a US trademark registration in an article. I saw that there's a template for a patent (Template:Cite patent) and was curious if there was something similar for a trademark as well. Appreciate any guidance. (Guyinblack25 talk 03:04, 29 April 2025 (UTC))
I've always "known" that direction quotations must be cited immediately after the quote, even if an end of paragraph citation would normally cover it. This leads me to write paragraphs like:
In 1916, Abramson designed the Home of the Daughters of Jacob on 167th Street between Findlay and Teller Avenues in the Bronx. The building consists of eight wings arranged radially around a central core, and has been described as "novel in design, being in the form of a wheel".[1] The property consists of 36 lots which were previously part of Gouverneur Morris's estate; at the time of purchase by the Daughters of Jacob, it was still occupied by Morris's 1812 house which was torn down to make room for the new building.[1]
where I put a citation directly after the "novel in design, being in the form of a wheel" quote, even though the exact same reference appears at the end of the paragraph. This has always seemed silly to me.
Looking at WP:INTEXT, I see it says In-text attribution may need to be used with direct speech ... An inline citation should follow the attribution, usually at the end of the sentence or paragraph in question
which sure sounds to me like the extra citation immediately after the quote is not actually needed. Am I just mis-reading this? Can I condense duplicate citations like this into a single one at the end of the paragraph?
References
- ^ a b "Lay Stone for New Home". New York Times. October 30, 1916. p. 8. Retrieved November 11, 2024.
RoySmith (talk) 22:19, 3 May 2025 (UTC)
- Maybe I've been doing it wrong? But I put the cite at the end of the content it supports, even if there's a direct quote in there. Schazjmd (talk) 22:25, 3 May 2025 (UTC)
Should the text of Wikipedia:Citing sources be changed to prefer templates over hand-formatted citations, while welcoming contributions from editors who continue to format manually? 23:53, 6 May 2025 (UTC)
Specific changes proposed:
- Change "(Note that templates should not be added without consensus to an article that already uses a consistent referencing style.)" to "(Templates are preferred, but contributions with manually-formatted citations are welcome.)"
- Add "change citations from manually formatted to templates, without admonishing of contributors" to "Generally considered helpful"
- Change the line starting "adding citation templates to an article that already uses a consistent system without templates" in "To be avoided" to "removing citation templates that are used correctly"
- Change the first paragraph of WP:CITECONSENSUS to: "Citation templates are preferred in situations where they exist and can be used as designed. They keep citations formatted in a consistent way and are more machine-readable for a variety of purposes. Contributions of manually-formatted citations from editors unfamiliar with or who simply do not care to use templates are welcome, and may be reformatted into templates by other editors without notification beyond a polite edit summary."
- Add to "Generally considered helpful" the line: "Adding or enhancing templates and modules for recurring situations where citations would be otherwise left manually-formatted due to lack of support"
Discussion: RFC on preferring templates in citations
[edit]- Proposer rationale: This proposal would still allow any citation format to be used consistently throughout an article, but would allow interested editors to move from hand-formatted to template-formatted citations for the following reasons:
- Much more consistently formatted output, tolerating variation in human-written input, resulting in a more professional and trustworthy appearance for articles.
- Automatic output of COinS metadata for browser plugins and web spiders that power data aggregators.
- Automatic detection of errors, such as dangling references, incomplete or vague citations, putting the wrong information in the wrong place, or using disfavored formats (such as for dates).
- Automatic improvement by bots (e.g. adding archive URLs, adding missing data and links to full text).
- Much easier to make future changes site-wide to formatting if consensus changes.
- Much easier to change an article's citation format (if consensus finds the wrong one was chosen) simply by substituting templates or (with module support) simply adding a "mode" declaration to the page. This also makes it easier to move citations between articles that have different citation formats. (We can already set "mode=cs1" or "mode=cs2".)
- Inexperienced editors (or those who simply prefer them) can use graphical tools like VisualEditor to add and edit citations without having to know wiki syntax or the formatting details of the specific citation style used by an article. Editors who use the source editor will still be under no obligation to use templates in new citations if they dislike them.
- Manual formatting of citations should not be used as a workaround to avoid mangling by a bot. An explicit bot exclusion is a better way to handle this because it alerts future editors to the bug and prevents them from stumbling into it again. This also facilitates research into bot improvements.
- According to the previous discussion, about 80% of articles already use citation templates, so the result of this guideline change is not much different than simply implementing our existing rule that articles should use a consistent format. Upgrading citations also provides an opportunity to eyeball neglected articles and passages and remove any obvious garbage. -- Beland (talk) 23:53, 6 May 2025 (UTC)
- Oppose major change to WP:CITEVAR allowing the imposition of a new citation style at the whim of gnomes and encouraging gnomes to perform this imposition, regardless of whether the citations are already in a consistent format. Inconsistently formatted manual citations do not need this change; a consistent style can be chosen for them regardless. The only actual point of these changes is to impose machine-friendly human-unfriendly rigid templated metadata on citations.
- —David Eppstein (talk) 00:42, 7 May 2025 (UTC)
- Oppose addressing rationale: #1, #5 and #6 are disingenuous, don't care about #2, #3 and #4 are hopelessly naive, #7 is no different from present, and #8 is nonsensical. ~~ AirshipJungleman29 (talk) 01:12, 7 May 2025 (UTC)
- Oppose. In addition to the points made by David Eppstein and Airship, allowing manually formatted citations makes it much easier to copy them from external sources, and much easier to incorporate subject-matter experts into the community. Templates don't magically make citations look professional nor address vague or misplaced citations. And forbidding manual formatting of citations as a workaround to known problems is a non-starter. See also the thousands of words here explaining some of the issues with the concept of this proposal. Nikkimaria (talk) 01:20, 7 May 2025 (UTC)
- Editors would still be allowed to copy already-formatted citations from other web sites. What problems are you seeing that require manual formatting as a workaround? -- Beland (talk) 03:23, 7 May 2025 (UTC)
- Saying that others can clean up after them is not a good solution to something that's not a problem to begin with. As to workarounds, there seem to be several examples of issues provided in the discussion above. Nikkimaria (talk) 03:54, 7 May 2025 (UTC)
- I looked into the situations mentioned in the previous discussion, and it seems they can all be dealt with by putting an HTML comment in the citation template that instructs the problematic bot not to edit it. That seems better than laying a trap for someone who later comes along and changes the citation to use a template for whatever reason, and it gets tread on by the bot again. -- Beland (talk) 04:14, 7 May 2025 (UTC)
- Saying that others can clean up after them is not a good solution to something that's not a problem to begin with. As to workarounds, there seem to be several examples of issues provided in the discussion above. Nikkimaria (talk) 03:54, 7 May 2025 (UTC)
- Editors would still be allowed to copy already-formatted citations from other web sites. What problems are you seeing that require manual formatting as a workaround? -- Beland (talk) 03:23, 7 May 2025 (UTC)
- Strongly oppose – allowing style variations at authors' discretion and leaving decision to local consensus is one of the best ways Wikipedia avoids pointless conflict and churn. There's not much benefit for every page to be perfectly consistent in every aspect of style, and the potential harms of changing this are dramatic. Aside: every editor should at least read and consider User:Jorge Stolfi § Please do not use {{cite}} templates.–jacobolus (t) 01:53, 7 May 2025 (UTC)
- If you want to render citations e.g. "issue 10" instead of "(10)", I agree that would be an improvement. It could be done across millions of citations in a single edit because they use templates and not manual formatting. We could also allow articles to easily choose to do this or not by adding a mode selector. -- Beland (talk) 03:21, 7 May 2025 (UTC)
- Implementing a mode selector to "easily choose to do this or not" would require people to (a) notice a change in the template's behaviour, (b) figure out how to create the option to override it in the template, (c) get that template change implemented, and then (d) change the article. That's not a particularly easy process compared to just formatting refs manually. Nikkimaria (talk) 03:54, 7 May 2025 (UTC)
- It's much easier than going through every single manually formatted citation and manually re-formatting them. -- Beland (talk) 04:09, 7 May 2025 (UTC)
- No, it's really not. First off, if someone has already manually formatted a citation in a way that they feel is appropriate, no reformatting is required regardless of what changes in the template. If there is a desire to change the format, either way you'd have to go through every single citation - but the template approach adds a bunch of extra work to do that, because first you'd have to change the template and then change the citations in the article. Nikkimaria (talk) 05:00, 7 May 2025 (UTC)
- Sure, I guess there are some scenarios where there is more upfront cost. If an article is already consistently formatted manually and wants to change to a different format, it will need to have all the citations re-formatted either way, and if it's done the template way and that style is not already supported, template upgrades will also have to happen. But compared to the number of articles (millions) the number of citation styles is quite small (less than ten?) so templates will seldom need to be upgraded to support new styles. The benefit of that investment in this scenario is only realized if there is a second style change where the entire page can be flipped with a mode setting.
- Maybe that happens with mature articles scoring high assessment grades, but I work on a lot of articles with detected typos, and I often see a mix of clashing citation styles on the same page. For those, most of the citations are going to have to be reformatted regardless of the chosen destination style. My thought is, why not make that destination style a template, so that we never have to do another mass-reformat no matter what changes about the preferred citation style? Also, a common way to fix poorly formatted citations is to use a script like reFill, which outputs templates. If we chose a non-template style, we'd have to do a lot of work to make up for the lack of automation, and then even more work after that to make up for the lack of automation finding archival URLs. -- Beland (talk) 07:10, 7 May 2025 (UTC)
- There are literally thousands of citation styles that exist. I grant you that most are part of a long tail, but that's still a heck of a lot of template changes. Archival URLs are already automatically added on articles without templates, so that's not a benefit of mandating templates.
- If you're encountering an article with clashing citation styles, you're already allowed to make that consistent, using templates if that's what you prefer to do. Your proposal doesn't change anything about that use-case; it instead targets articles that already have a consistent style that just happens to not be template-based.Nikkimaria (talk) 22:04, 7 May 2025 (UTC)
- It does prevent people from changing inconsistent articles to manually formatted citations, which is work that would have to be undone later if in the long term we are moving in the direction of using templates universally. And if that's the direction we're going, we might as well start on the manually formatted articles, too.
- I can't imagine people creating thousands of style templates for tiny variations; it would be a lot less work just to use templates for a popular style very close to one's preferred style. That also seems like a crummy experience for readers, looking at a thousand different styles and either having to learn to interpret a bunch of different conventions (extra difficult for those who are not native English speakers) or just being annoyed at what looks like sloppiness.
- I don't know of any bots that can operate on manual citations to validate date formats, find dangling references, create markup for COinS, fill in missing authors, or connect citations to databases like DOI. -- Beland (talk) 23:34, 7 May 2025 (UTC)
- But we shouldn't be preventing people from improving citations, even if we might sometime eventually want to change how they've done that.
- I agree with you re:
I can't imagine people creating thousands of style templates for tiny variations
- that's why I don't think your proposal about template upgrades and mode settings is at all workable. What is more likely to happen is (a) users try to shoehorn their preferred formatting into citation templates and get into edit-wars with well-intentioned bots or gnomes (as already happens!), or (b) users manually format citations to get their preferred formatting, and then get into edit-wars as a result of your proposal. As tocrummy experience for readers
, I don't see any evidence that CS1 is a better experience for readers than APA, MLA, or any other format you could name - the page jacobulus linked has already suggested some ways in which a non-CS1 format might easier to interpret. - Bots aren't the panacea you suggest - see Jc's comments. Nikkimaria (talk) 00:42, 8 May 2025 (UTC)
- If an article has two citations, and one of them is manually formatted and the other uses a citation template (assuming reasonably equivalent contents: they both have the source's title, a URL, etc.), is removing the citation template actually a case of "improving citations"? WhatamIdoing (talk) 00:52, 8 May 2025 (UTC)
- All else being equal, as much as adding one. Nikkimaria (talk) 02:00, 8 May 2025 (UTC)
- Maybe not?
- Because I think that eventually – maybe after I die, but some day in the future – citation templates will grow from "merely" 80% of articles having some to basically all articles using them for everything, and that means that the process will be:
- Start with a 50–50 mix.
- Switch to templates.
- Done.
- vs
- Start with a 50–50 mix.
- Switch to manual formatting.
- Eventually switch back to templates.
- Finally done.
- And therefore I think that putting a finger very lightly on the scale in favor of citation templates will save time, net, in the end. WhatamIdoing (talk) 02:27, 8 May 2025 (UTC)
- All else is not equal; templated citations are more useful for browser plugins, data aggregation, and more easily changed en masse. Which is why this proposal would define one direction as an improvement.
- I think it would be reasonable to call a truce among say, the top 5 or so most popular citation styles and support those with templates, for compatibility with various academic fields and major published style guides and what people learned to use at school. It's reasonable to ask people to pick one of those and not to force our readers to learn citation style #534 which they came up with one day while filling a complaint with the local dog catcher. There are hundreds of style rules; generally the way they reduce edit wars is by providing unambiguous answers to arbitrary questions. -- Beland (talk) 02:50, 8 May 2025 (UTC)
- All else being equal, as much as adding one. Nikkimaria (talk) 02:00, 8 May 2025 (UTC)
- If an article has two citations, and one of them is manually formatted and the other uses a citation template (assuming reasonably equivalent contents: they both have the source's title, a URL, etc.), is removing the citation template actually a case of "improving citations"? WhatamIdoing (talk) 00:52, 8 May 2025 (UTC)
- No, it's really not. First off, if someone has already manually formatted a citation in a way that they feel is appropriate, no reformatting is required regardless of what changes in the template. If there is a desire to change the format, either way you'd have to go through every single citation - but the template approach adds a bunch of extra work to do that, because first you'd have to change the template and then change the citations in the article. Nikkimaria (talk) 05:00, 7 May 2025 (UTC)
- It's much easier than going through every single manually formatted citation and manually re-formatting them. -- Beland (talk) 04:09, 7 May 2025 (UTC)
- That sounds very complicated and controversial, likely to waste vast amounts of effort and attention on style nitpicks. This discussion itself is already doing significant harm, insofar as the participants might otherwise be making productive content contributions. –jacobolus (t) 05:20, 7 May 2025 (UTC)
- I accept your opinion that content is more important than style. As a community of editors, though, it seems we have decided that style is important enough to worry about that we do have a Manual of Style instead of willy-nilly formatting, and we have decided that it should be consensus-driven rather than saving a lot of time by handing it over to a benevolent dictator or style committee. I can't think of a way to reconcile those choices with the idea that we can't have this type of discussion because it burns time we should be spending on content. It's a valid concern, though I'm not sure we're spending "significant" resources on it given how many thousands of edits are being committed while we're having this discussion. Also keep in mind that not everyone who enjoys wikignoming also enjoys working on content. Part of the reason I do a lot of wikignoming fixing spelling and style errors is so that other editors can focus more on their area of expertise and interest and don't need to be distracted fixing small things that I could fix more quickly en masse. And some days I'm too tired or stressed to wrangle a lot of prose and I just need to relax by fixing a bunch of malformed punctuation or unconverted units of measure. -- Beland (talk) 07:31, 7 May 2025 (UTC)
- Implementing a mode selector to "easily choose to do this or not" would require people to (a) notice a change in the template's behaviour, (b) figure out how to create the option to override it in the template, (c) get that template change implemented, and then (d) change the article. That's not a particularly easy process compared to just formatting refs manually. Nikkimaria (talk) 03:54, 7 May 2025 (UTC)
- If you want to render citations e.g. "issue 10" instead of "(10)", I agree that would be an improvement. It could be done across millions of citations in a single edit because they use templates and not manual formatting. We could also allow articles to easily choose to do this or not by adding a mode selector. -- Beland (talk) 03:21, 7 May 2025 (UTC)
- Oppose per David Eppstein and AirshipJungleman29. We want people to leave citations that support the information they add. That is far more important than putting people off by insisting on using a cumbersome or alien format that they do not understand. And what to do with people who can’t work in templates? Are we going to punish them for adding what may be good content with a good source if they do it the old fashioned way? It’s unworkable and unnecessary. - SchroCat (talk) 03:46, 7 May 2025 (UTC)
- I agree with your concerns. The language is meant to explicitly to welcome non-template contributions and advise against "punishing" contributors who do that. Specifically: "Contributions of manually-formatted citations from editors unfamiliar with or who simply do not care to use templates are welcome, and may be reformatted into templates by other editors without notification beyond a polite edit summary." and "contributions with manually-formatted citations are welcome". Is there some other language that would make that more clear? -- Beland (talk) 04:12, 7 May 2025 (UTC)
- I get that you want this to happen, but there’s no need to bludgeon every comment that is made. - SchroCat (talk) 04:20, 7 May 2025 (UTC)
- I'm trying not to bludgeon (and was actually hoping to just ignore this RFC for a few days); I'm answering the questions you asked. It was honestly unclear to me if you had read the proposed text which is supposed to solve exactly the problem you raised and upon thinking it through still came to the same conclusion, or if you were mostly just reacting to the title of the RFC? Maybe I'm missing something; do you think editors will feel that manually formatted contributions will be unwelcome when they read that templates are preferred, even though it also explicitly says those contributions are welcome? Do you think editors won't follow the guideline telling them not to complain about those contributions? Do you think just arriving at a page and seeing all the citations already using templates will put off potential contributors?
- I'm fine with this not happening - though I think it would be tidier and easier to maintain, I realize a lot of people have a lot of strong opinions about formatting. Hanyangprofessor2's questioning of the current guideline generated several comments favoring either encouraging templates or going even further and having a single citation style for all of Wikipedia. Seemed to me like it was time to check in and see if consensus on this has changed, but if it hasn't, there's plenty of work to be done cleaning up citations under the existing style rules. -- Beland (talk) 06:58, 7 May 2025 (UTC)
- You really are bludgeoning this, despite saying you're not. Your name is already appearing far too frequently contradicting those !voting against this So far, I think nine people have commented in this thread and you've made nine comments throughout the thread, all to those who oppose it. Please just let please comment without interference. - SchroCat (talk) 07:48, 7 May 2025 (UTC)
- This is supposed to be not merely a tallying up of opinions, but a discussion with the possibility of improvement and compromise. But if you are uninterested in exploring mitigation of whatever problem you are foreseeing and just want let your opinion stand, that's fine; I will sit in confusion given that we seem to be in agreement and disagreement simultaneously. -- Beland (talk) 08:59, 7 May 2025 (UTC)
- I am NOT tallying up opinions - that's a complete mischaracterisation of what I have written, which is clear to anyone reading it. I was pointing out that nine people have made comments in this thread (that's tallying contributors, not opinions) and you have now made ten comments. To quote from the guideline: "
If your comments take up one-third of the total text or you have replied to half the people who disagree with you, you are likely bludgeoning the process
". - SchroCat (talk) 09:31, 7 May 2025 (UTC)
- I am NOT tallying up opinions - that's a complete mischaracterisation of what I have written, which is clear to anyone reading it. I was pointing out that nine people have made comments in this thread (that's tallying contributors, not opinions) and you have now made ten comments. To quote from the guideline: "
- This is supposed to be not merely a tallying up of opinions, but a discussion with the possibility of improvement and compromise. But if you are uninterested in exploring mitigation of whatever problem you are foreseeing and just want let your opinion stand, that's fine; I will sit in confusion given that we seem to be in agreement and disagreement simultaneously. -- Beland (talk) 08:59, 7 May 2025 (UTC)
- You really are bludgeoning this, despite saying you're not. Your name is already appearing far too frequently contradicting those !voting against this So far, I think nine people have commented in this thread and you've made nine comments throughout the thread, all to those who oppose it. Please just let please comment without interference. - SchroCat (talk) 07:48, 7 May 2025 (UTC)
- I get that you want this to happen, but there’s no need to bludgeon every comment that is made. - SchroCat (talk) 04:20, 7 May 2025 (UTC)
- I agree with your concerns. The language is meant to explicitly to welcome non-template contributions and advise against "punishing" contributors who do that. Specifically: "Contributions of manually-formatted citations from editors unfamiliar with or who simply do not care to use templates are welcome, and may be reformatted into templates by other editors without notification beyond a polite edit summary." and "contributions with manually-formatted citations are welcome". Is there some other language that would make that more clear? -- Beland (talk) 04:12, 7 May 2025 (UTC)
- @AirshipJungleman29, @David Eppstein, @Jacobolus, @Nikkimaria, @SchroCat: I wonder what you would think about a short, simple factual statement, like "While citation templates are the most popular choice, using them is not actually required". (If anyone's curious, we ran the numbers: about 80% of articles contain at least one CS1|2 citation template.) WhatamIdoing (talk) 05:28, 7 May 2025 (UTC)
- I think the proposal is not just a solution in search of a problem, but a positive backwards stop that will inhibit editors, particularly the less experienced from adding citations. I am a huge fan and use them in 95 per cent of the material I add, but we should not be creating artificial hurdles that stop people from adding sources. That's only going to damage us. - SchroCat (talk) 07:48, 7 May 2025 (UTC)
- Based on the discussion above, I don't think that the OP has any interest in "creating artificial hurdles that stop people from adding sources". I think the goal is more like "if you put
[https://www.example.com/source.html|Title of source]
in ref tags, then let's have an official rule saying I can quietly turn that into {{cite web}} for you". - Because, in practice, that's what happens. The manually formatted citations are almost never beautifully formatted examples of any style guide, they almost never form a "consistent" citation style, and they regularly do get converted to citation templates. We just sort of pretend in WP:CITEVAR that everything's equal, when it's really not equal. WhatamIdoing (talk) 16:29, 7 May 2025 (UTC)
- Unfortunately (as I think you've found elsewhere!) once the language is added it really doesn't matter what the OP's intentions were. Nikkimaria (talk) 00:42, 8 May 2025 (UTC)
- True, and I'm not wild about the proposed language. (For one thing, there's a lot of it.) But given the apparent intention, I think it might be possible to find language that meets the goal without making people think that it's a bot free-for-all. (Yes, that's an odd conclusion for text that doesn't mention bots at all, but I've had discussions in which I've told editors that if we moved one section of text out of a {{policy}} to another page, with no changes to the text and with its own copy of the {{policy}} tag on the new policy page, it would still be a policy, and they still thought it would result in the new policy page not being a policy. That's a plural they, by the way: two editors had difficulty with the concept. Wikipedia is one of the few sites on the internet that really does (and values) close reading, but we don't always pay attention.) WhatamIdoing (talk) 02:24, 8 May 2025 (UTC)
- Unfortunately (as I think you've found elsewhere!) once the language is added it really doesn't matter what the OP's intentions were. Nikkimaria (talk) 00:42, 8 May 2025 (UTC)
- Based on the discussion above, I don't think that the OP has any interest in "creating artificial hurdles that stop people from adding sources". I think the goal is more like "if you put
- I think the proposal is not just a solution in search of a problem, but a positive backwards stop that will inhibit editors, particularly the less experienced from adding citations. I am a huge fan and use them in 95 per cent of the material I add, but we should not be creating artificial hurdles that stop people from adding sources. That's only going to damage us. - SchroCat (talk) 07:48, 7 May 2025 (UTC)
- Oppose after reading through above. I'm a big fan of the templates, they help me input without much thought, and they help me understand what each piece of information is in others' sources. However, at its core, "This page in a nutshell: Cite reliable sources." It's gratifying when an IP editor adds a bare url, and if they want to manually add more information in plain text, this page should takes pains not to discourage this. Past a certain point of relevant information being included, the marginal benefit of encouraging gnoming to change manual sources into template sources seems limited. CMD (talk) 05:31, 7 May 2025 (UTC)
- Tentatively Support. As far as I can tell, this is how we operate by default in WP:MED, and I feel that the consistency of citation formatting is a big part of why medical articles tend to be easy to verify and to conduct further reading on. It also is pretty much immediately apparent when there's an "ugly duck" citation that is almost certainly subpar. I understand that not all of Wikipedia can or should be held to the standards of medicine, but at the same time, I think our pages are broadly a good demonstration of why this proposal has merit. That being said, I would like to hear what @Boghog has to say about this, and may well change my mind depending on what the medical citation master says. Just-a-can-of-beans (talk) 06:37, 7 May 2025 (UTC)
- Oppose. We need to be rigid about verifiability but not about how to write references. See the top of my user page which starts with a large quote symbol and
Don't worry about formatting references; just get all the information in there.
Effective editors work in different ways and it is a mistake to try to dictate what they should do when it does not affect the reading of articles. I happen to love reference templates, but the hard task is to teach new editors why references are important and how to find the right kind of sources. Lets focus on that. StarryGrandma (talk) 14:34, 7 May 2025 (UTC) - Oppose Per Nikkimaria, CMD, and StarryGrandma. Ealdgyth (talk) 14:41, 7 May 2025 (UTC)
- Oppose implementation by bots, weak oppose in general. Previous discussion is full of complaints about what a bad job bots do of creating templates. Jc3s5h (talk) 15:05, 7 May 2025 (UTC)
- Oppose, per most of the comments above, particularly StarryGrandma. Mike Christie (talk - contribs - library) 16:31, 7 May 2025 (UTC)
- Mixed
- Support Encouraging use of templates and adding missing facilities. Use of templates makes changes in style easier.
- Strongly Oppose any wording that encourages mass changes via bots. They break things too often. -- Shmuel (Seymour J.) Metz Username:Chatul (talk) 16:34, 7 May 2025 (UTC)
- I don't see any wording encouraging people to use bots. Are you referring to "They keep citations formatted in a consistent way and are more machine-readable for a variety of purposes."? Would you like to have that sentence dropped? -- Beland (talk) 22:56, 7 May 2025 (UTC)
- It isn't sufficient to not mention bots. The proposal should include language that strongly discourages bots. I'll add more on machine readability below. Jc3s5h (talk) 23:06, 7 May 2025 (UTC)
- Isn't the bot approval process the right place to make that sort of decision? Normally that's done on a per-bot basis rather than a blanket rule, to take into account different pros and cons. -- Beland (talk) 23:37, 7 May 2025 (UTC)
- The bot approval group is very pro-bot, and will be thrilled to approve citation-related bots with an error rate that many of us think is far too high. When is the last time a bot author was told "fix every mistake your bot made and do nothing else on Wikipedia until you're finished, on pain of a community band"? The prohibition must be in the guideline. Jc3s5h (talk) 23:52, 7 May 2025 (UTC)
- Are you talking about unsupervised bots or those with many human operators who are supposed to verify the output? I used to operate an unsupervised bot and administrators did not hesitate to block the bot if it made mistakes which I then had to clean up or explain as not mistakes. -- Beland (talk) 02:10, 8 May 2025 (UTC)
- From what I've seen, users who invoke supposedly supervised bots don't do an effective job of making sure the output is correct. A bot that tries to automatically change an article from free-form citations to citation templates would produce a mass of changes all mixed together, and the human thinking process just isn't good at checking that kind of change. Jc3s5h (talk) 02:16, 8 May 2025 (UTC)
- Nothing in this proposal suggests writing a bot to change citations from manually-formatted to template. The whole idea is that bots have an easier time after the conversion, because the humans have done the hard part of segmenting strings into appropriate semantic fields. -- Beland (talk) 06:59, 8 May 2025 (UTC)
- The current rule of not allowing changes from consistent non-templated to templates serves as a restriction against doing this with bots. So it does encourage the use of bots, even though it doesn't mention bots. Jc3s5h (talk) 09:41, 8 May 2025 (UTC)
- I suppose that's true, but only on the ~20% of pages (plus or minus those that use only one or two templates that violate an otherwise consistent style) that don't already use at least some templates. On most pages, bots could theoretically change citations from hand-formatted to template-formatted in order to achieve consistency or get rid of a style that violates the other rules of the MOS (like using all caps). Assuming that bot could get bot approval and be smart enough to actually do that. So it seems like that should already be a huge problem if it was something actually likely to happen. -- Beland (talk) 00:18, 9 May 2025 (UTC)
- The current rule of not allowing changes from consistent non-templated to templates serves as a restriction against doing this with bots. So it does encourage the use of bots, even though it doesn't mention bots. Jc3s5h (talk) 09:41, 8 May 2025 (UTC)
- Nothing in this proposal suggests writing a bot to change citations from manually-formatted to template. The whole idea is that bots have an easier time after the conversion, because the humans have done the hard part of segmenting strings into appropriate semantic fields. -- Beland (talk) 06:59, 8 May 2025 (UTC)
- From what I've seen, users who invoke supposedly supervised bots don't do an effective job of making sure the output is correct. A bot that tries to automatically change an article from free-form citations to citation templates would produce a mass of changes all mixed together, and the human thinking process just isn't good at checking that kind of change. Jc3s5h (talk) 02:16, 8 May 2025 (UTC)
- Are you talking about unsupervised bots or those with many human operators who are supposed to verify the output? I used to operate an unsupervised bot and administrators did not hesitate to block the bot if it made mistakes which I then had to clean up or explain as not mistakes. -- Beland (talk) 02:10, 8 May 2025 (UTC)
- The bot approval group is very pro-bot, and will be thrilled to approve citation-related bots with an error rate that many of us think is far too high. When is the last time a bot author was told "fix every mistake your bot made and do nothing else on Wikipedia until you're finished, on pain of a community band"? The prohibition must be in the guideline. Jc3s5h (talk) 23:52, 7 May 2025 (UTC)
- Isn't the bot approval process the right place to make that sort of decision? Normally that's done on a per-bot basis rather than a blanket rule, to take into account different pros and cons. -- Beland (talk) 23:37, 7 May 2025 (UTC)
- It isn't sufficient to not mention bots. The proposal should include language that strongly discourages bots. I'll add more on machine readability below. Jc3s5h (talk) 23:06, 7 May 2025 (UTC)
- Support, the technical benefits are overwhelming. But oppose bots; understanding is still needed to avoid errors. Ifly6 (talk) 16:54, 7 May 2025 (UTC)
- Oppose - a one-size-fits-all diktat is not helpful. As long as citations are clearly and accurately presented to our readers it does not matter a rap whether templates are or are not used. Tim riley talk 17:18, 7 May 2025 (UTC)
- Oppose - what matters is that sufficient information is given to allow readers and editors to know what the source is and to find the information. Enforcing citation templates (which this proposal will effectively mean even if it isn't wording that strongly or meant by the proposers) won't help this and will inevitably break some references as data is unthinkingly rammed into fields just to get it into the template - whether correct or not. In addition forcing some "One True Wikipedia Reference Style" will drive some editors away, because it isn't the style that the editors are used to / is standard in that field, and this is just the sort of annoying little thing that gets some people angry enough to quit.Nigel Ish (talk) 17:54, 7 May 2025 (UTC)
- support - "use whatever is easiest for you, and let someone else worry about reformatting it to get the many benefits of structured syntax" doesshould not be controversial (which isn't to say I'm surprised it is - I've opposed a lot of style standardization proposals in the past myself). I'm just having trouble finding a persuasive objection in the opposes as to why we should not have better archive links, why we should get in the way of the many tools that improve accessibility and verifiability, why we should make it harder for users of visual editor to work on citations, etc. — Rhododendrites talk \\ 22:44, 7 May 2025 (UTC)
- "They keep citations formatted in a consistent way and are more machine-readable for a variety of purposes." I've seen too much sentiment that being machine-readable and bot-friendly comes first, and the ability of the editor to write a cite for any source the editor has access to comes second. The book in the editor's hand doesn't have an ISBN? Let bots add an ISBN for a similar book. Source has a publication date that's not supported by templates, such as Michaelmas term, 2001? Issue an error message. The guideline should very strongly discourage changing a manual citation into a template if there isn't a citation template that fully supports the source, and if the editor who wants to make the change can't prove the correctness of the revised citation because the templatephile doesn't have the source in hand. Jc3s5h (talk) 00:03, 8 May 2025 (UTC) (fixed in light of comments)