Difference between revisions of "Help talk:Style/Article summary templates"

From ArchWiki
Jump to: navigation, search
(See also or Related in Article Summary?: + advantage)
(Procedure: update?)
 
(55 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Writing Article Overviews|Article summary templates]] provide a place to sum up the content of the aricle. The problem is that, in my opinion, this conflicts with the text written in the first part of the articles, before the first heading, which is kind of used for the same purpose. You can see this even in the page I've linked at the beginning of the paragraph, and in [[Writing_Article_Introductions]].
+
==<s> See also or Related in Article Summary? </s>==
I suggest that the summary should only be written as normal text before the first heading, and that Article summary templates should be used only to provide additional schematic introductory informations, like links to related articles (also note that this could conflict with "See also" sections), using the Overview templates, listing packages to download (like in [[Trinity]]) and so on. [[Writing Article Overviews]] and [[Writing Article Introductions]] should be edited in accordance, or maybe merged with this very article? (They actually talk about style) -- [[User:Kynikos|Kynikos]] 12:12, 3 May 2011 (EDT)
+
:I never liked those summary templates and I prefer to have all the related links either in the article itself or at the bottom in the "See also" section. The introduction should have info like ''This is an article about foo. If you're looking for foo2, go to <u>this</u> page and if you want bar, go to <u>this</u> page.'' Examples [[GNOME]] v. [[GNOME 3]], [[Virtualbox]] v. [[Arch Linux VirtualBox Guest]]. -- [[User:Karol|Karol]] 13:24, 3 May 2011 (EDT)
+
::Would you definitively deprecate Article summary templates? It would KISS things up, I could agree.
+
::Let's try to be concrete, otherwise discussions like this can last for eternity: I'm listing all the possible uses for Article summary (add more if you can think of others), then evaluate each briefly to see if it can be put back in the "normal flow" of the article:
+
::*Article summary:
+
:::it could easily (and I think should) be always substituted by the text before the first heading (which appears before the ToC);
+
::*Overview template:
+
:::more hardly replaceable, unless we just list its links in the See also section and get rid of the rest of the description; I don't like Overview templates very much, they could also be included in the normal summary at the beginning of the article;
+
::*Related articles and other links (Wikipedia articles, Series, Changelogs...):
+
:::easily mergeable with the See also section, anyway I don't know if I would like the opposite more;
+
::*Legal info:
+
:::This is rarely used ([[Fonts]] is the only occurrence I've found with a brief random search); it could be easily integrated in the normal flow;
+
::*List of packages:
+
:::Also rarely used ([[Trinity]] is the only occurrence I can think of at the moment); it could be integrated in the normal flow, though a long list would not look as good.
+
::*...?
+
::In the end, I would start removing the conflict for the summary itself, and then take care of the rest, also because a lot of articles make use of these templates in various ways.
+
::As always the last word will come from the administrators. -- [[User:Kynikos|Kynikos]] 17:54, 3 May 2011 (EDT)
+
:::In my mind, the ''introduction'' should be used to describe the topic of the article whereas the ''summary'' should be used to describe the structure and scope of the article. E.g. Introduction: X is an application that turns your computer into a killer robot. Summary: This article covers installation and configuration of X. A slight distinction, I will admit. (Analogy: abstract versus introduction in research articles).
+
:::I created the overview templates as a way to add context to the ''related'' articles. Yes, article X is related to Y, but in what way? I also prefer seeing related links at the beginning rather than the end of articles.
+
:::-- [[User:Pointone|pointone]] 23:03, 4 May 2011 (EDT)
+
::::Well I agree about the links: as we are trying to standardize the style you could consider approving to move all links from See also and External links sections to the Summary box.
+
::::About introduction and summary, I still think the difference is really too subtle to be noticed and applied in all the articles without having to puzzle over what to write where. We should think well if it really gives an advantage to have the two kind of text separated; also IMHO the purpose of the summary, as you have descripted it, is almost completely fulfilled by the Table of Contents. -- [[User:Kynikos|Kynikos]] 10:36, 5 May 2011 (EDT)
+
  
::I’m not really a fan of these floating templates either. I tend to start reading a page sequentially, at least until I get a feel for what the page is about and decide if I am reading the right page or not. I ignore these sort of floating boxes because they don’t visually have a place in the main text sequence. I often just assume that if they contained important information, that information would be present in the main body as well. Perhaps I would take more notice of these templates if they were on the left (since I read from left to right), but on the other hand perhaps that would make me even more annoyed at the pages that use those templates :P.
+
''[Moved to [[Help talk:Style#See also or Related in Article Summary?]] -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 04:29, 5 July 2014 (UTC)]''
  
:: How do the templates help add context to related articles? [[User:Vadmium|Vadmium]] 06:13, 1 August 2011 (EDT).
+
== Deprecation of summaries and overviews ==
:::I was referring to the so-called ''overview'' templates such as [[Template:Package management overview]]. I believe this adds context to related articles rather than simply saying "See also: [[pacman]], [[Arch Build System]], [[PKGBUILD]], etc." However, the overviews can be moved to respective category pages, as touched upon in [[#A crazy idea (about Summary templates, Overview templates and categories)]]. -- [[User:Pointone|pointone]] 14:18, 22 September 2011 (EDT)
+
As discussed in [[#Original discussion]], although '''article summaries''' were intended to have a different use from introductions, this difference is really too subtle to be understood by many, and this is reflected by the fact that in the vast majority of articles, if not in all of them, article summaries are misused, especially in two ways:
 +
* they substitute or duplicate the introduction
 +
* they provide a useless summary that is already evident by looking at the table of contents
 +
Often an article summary is added only to justify the floated box in order to add related links, just click a few times on [[Special:Random]] and see for yourself.
  
Is the Article Summary to be optional or required (mandatory) on every article? And if it's optional, the choice is purely based on authors' preferences or do we suggest some guidelines? -- [[User:Kynikos|Kynikos]] 07:02, 17 September 2011 (EDT)
+
Second, as touched on in [[ArchWiki:Requests#Mention UEFI boot loaders in the overview]], '''overviews''' are hard to maintain and they seem an unnecessary complication, as a link to the main "overview" article would serve the purpose much better ([[Boot Loaders]] in that example), or, if an overview article is absent, an overview could be easily added to the article itself, e.g. in the introduction. Note that overviews are used very sparingly, so they can also be seen as a non-standard feature of our articles.
:I am neither for nor against the summary templates. The majority of users (here) are against them, so it would seem. -- [[User:Pointone|pointone]] 14:18, 22 September 2011 (EDT)
+
::Honestly, I would really like to deprecate every summary template except for the overviews, and I would finally implement [[#A crazy idea (about Summary templates, Overview templates and categories)]]: I read it again, and my own words "This way every category would have a brief description, Overview templates would become unnecessary (merged with category pages), all (categorized) articles would have an almost automatic overview, and people would be more willing to categorize pages well" have convinced me again of the advantages of such a system. -- [[User:Kynikos|Kynikos]] 17:32, 22 September 2011 (EDT)
+
:::As a start, I suggest we move the existing overviews to their respective category pages -- I support this part of your idea. However, as for including category overviews in the article summary, what happens if a page belongs to multiple categories? -- [[User:Pointone|pointone]] 18:21, 10 October 2011 (EDT)
+
::::Yeah I thought of that case, the article would just get multiple stacked overviews (I think it would be desirable, after all, and overviews shouldn't be 500-word texts, just brief descriptions). If however one wants to avoid displaying the overview of some categories, he can still use the normal categorization syntax.
+
::::Are we moving the existing overviews in their cat pages even if we've not yet reached a decision about the whole change?
+
::::-- [[User:Kynikos|Kynikos]] 19:02, 10 October 2011 (EDT)
+
:::::I like having the overviews in articles. The overview gives good information for wrapping your head around a new topic and having access to the most important related articles, and I often enjoy getting this info right after reading the intro. There isn't much of a place for overview-like material elsewhere in the article either, so I'd like if these stayed. Also, many of the most related links in the summary template can be incorporated into a good overview. [[User:Emiralle|Emiralle]] 13:17, 15 October 2011 (EDT)
+
::::::Don't worry, we're just discussing where to keep the source text of overviews, whether in templates or in proper categories, but in the articles the overviews will be displayed as always. -- [[User:Kynikos|Kynikos]] 13:21, 15 October 2011 (EDT)
+
:::::::Right. Well in that case I'm happy with them moving to category pages as well. Many categories don't have much (or any) descriptive writing so that would kill two birds with one stone. [[User:Emiralle|Emiralle]] 13:27, 15 October 2011 (EDT)
+
::::::::Ok, I'm trying this. -- [[User:Kynikos|Kynikos]] 15:04, 15 October 2011 (EDT)
+
:::::::::This part is implemented, the source texts of the 5 currently existing overview templates have been moved to relevant categories. The templates themselves however are still there.
+
:::::::::Related changes are [https://wiki.archlinux.org/index.php?title=Category:Security_%28English%29&diff=prev&oldid=166035], [https://wiki.archlinux.org/index.php?title=Template:Access_control_overview&diff=prev&oldid=166036], [https://wiki.archlinux.org/index.php?title=Category:Boot_loaders_%28English%29&diff=prev&oldid=166037], [https://wiki.archlinux.org/index.php?title=Template:Boot_process_overview&diff=prev&oldid=166038], [https://wiki.archlinux.org/index.php?title=Category:X_Server_%28English%29&diff=prev&oldid=166039], [https://wiki.archlinux.org/index.php?title=Template:Graphical_user_interface_overview&diff=prev&oldid=166040], [https://wiki.archlinux.org/index.php?title=Category%3ANetworking_%28English%29&action=historysubmit&diff=166042&oldid=146852], [https://wiki.archlinux.org/index.php?title=Template:Networking_overview&diff=prev&oldid=166043], [https://wiki.archlinux.org/index.php?title=Category:Package_management_%28English%29&diff=prev&oldid=166044], [https://wiki.archlinux.org/index.php?title=Template:Package_management_overview&diff=prev&oldid=166045]. -- [[User:Kynikos|Kynikos]] 15:43, 15 October 2011 (EDT)
+
  
==A crazy idea (about Summary templates, Overview templates and categories)==
+
This discussion, therefore, intends to plan the deprecation of both article summaries and overviews, leaving the right-floated box only for related links.
'''[Brainstorming mode ON]'''I don't even know if this could be feasible at all, but what if we could instruct the Article summary template to "read" (with an internal inclusion like those in the [[Beginners' Guide]]?) a specific standard section in each Category page that the article belongs to? That standard section would contain a description of the category, and that could somewhat replace the Overview templates. (How hard it is to explain insane ideas, further clarifications could follow)'''[Brainstorming mode OFF]'''. -- [[User:Kynikos|Kynikos]] 12:43, 3 May 2011 (EDT)
+
  
This is an example: looking at the code, I have used [[Template:Graphical user interface overview]], but with this method its text would be in the includable section (Overview) of the Category, and would be included (automatically with some template hacking?) in the Summary template field:
+
Now, there would be 2 * 2 main ways to implement this:
  
<div style="margin-left:10%; width:80%;">
+
'''1.''' Create a single [[Template:Related links]] template, that will host the links as its first argument
  
<div style="border:1px solid #666;">
+
'''2.''' Create two templates, [[Template:Related links start]], [[Template:Related links end]] that start and end the floated div, just like [[Template:Article summary start]] and [[Template:Article summary end]]
  
<p style="font-size:20px; font-weight:bold;">Lorem Ipsum</p>
+
'''A.''' Create a [[Template:Related]] template in order to induce users to use a standard formatting
  
<div style="padding:5px; float:right; width:25%;">
+
'''B.''' Allow content to be liberally added to the floated box
  
<p style="text-align: center; padding:3px; background:#333; color:white; font-size:13px; font-weight:bold;">Category: Desktop environments</p>
+
'''1A''':
<div style="text-align: left; padding: 3px">
+
{{bc|<nowiki>{{Related links|
<p><tt><nowiki>{{:Category:Desktop environments}}</nowiki></tt> (Would this work?)</p>
+
{{Related|Link A}}
<p>{{Graphical user interface overview}}</p>
+
{{Related|Link B}}
</div>
+
{{Related|Link C}}
<p style="text-align: center; padding:2px; background:#333; color:white; font-size:13px; font-weight:bold;">
+
}}</nowiki>}}
Related
+
</p>
+
<div style="text-align: left; padding: 3px">
+
<p>[[#Lorem Ipsum|Link 1]]</p>
+
<p>[[#Lorem Ipsum|Link 2]]</p>
+
<p>[[#Lorem Ipsum|Link 3]]</p>
+
</div>
+
<p style="text-align: center; padding:2px; background:#333; color:white; font-size:13px; font-weight:bold;">
+
External links
+
</p>
+
<div style="text-align: left; padding: 3px">
+
<p>[[#Lorem Ipsum|Link 1]]</p>
+
<p>[[#Lorem Ipsum|Link 2]]</p>
+
<p>[[#Lorem Ipsum|Link 3]]</p>
+
</div>
+
  
</div>
+
'''1B''':
 +
{{bc|<nowiki>{{Related links start}}
 +
{{Related|Link A}}
 +
{{Related|Link B}}
 +
{{Related|Link C}}
 +
{{Related links end}}</nowiki>}}
  
{{Lorem Ipsum}}
+
'''2A''':
{{Lorem Ipsum}}
+
{{bc|<nowiki>{{Related links|
{{Lorem Ipsum}}
+
[[Link A]]
{{Lorem Ipsum}}
+
{{Lorem Ipsum}}
+
{{Lorem Ipsum}}
+
{{Lorem Ipsum}}
+
{{Lorem Ipsum}}
+
{{Lorem Ipsum}}
+
{{Lorem Ipsum}}
+
{{Lorem Ipsum}}
+
{{Lorem Ipsum}}
+
{{Lorem Ipsum}}
+
{{Lorem Ipsum}}
+
  
<p style="margin:5px; border:1px solid #666;">Categories: Desktop environments</p>
+
[[Link B]]
  
</div>
+
[[Link C]]
 +
}}</nowiki>}}
  
<div style="border:1px solid #666; margin-top:20px;">
+
'''2B''':
 +
{{bc|<nowiki>{{Related links start}}
 +
[[Link A]]
  
<tt>&lt;noinclude&gt;</tt>
+
[[Link B]]
  
<p style="font-size:20px; font-weight:bold;">Category:Desktop environments</p>
+
[[Link C]]
<p style="font-size:16px; font-weight:bold;">Overview</p>
+
{{Related links end}}</nowiki>}}
  
<tt>&lt;/noinclude&gt;</tt>
+
My preference goes to '''1B'''.
  
{{Graphical user interface overview}}
+
I would be very strict and only allow simple internal links in the floated box, so no alternative link anchor, no link descriptions, no external links, no subheadings... That kind of links should only be used in "See also" sections. Of course any opposing opinions will be considered.
  
<tt>&lt;noinclude&gt;</tt>
+
-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 05:30, 10 November 2013 (UTC) (EDIT: [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:30, 10 November 2013 (UTC))
  
<p style="font-size:16px; font-weight:bold;">Subcategories</p>
+
: My preference is '''2B'''. It support <nowiki>[[fstab (简体中文)|fstab]]</nowiki> which is more clean. -- [[User:Fengchao|Fengchao]] ([[User talk:Fengchao|talk]]) 13:05, 10 November 2013 (UTC)
...
+
  
...
+
::Good point, I didn't think of language tags. I'd prefer using a Related template in order to discourage exotic uses of the floated box, and also because otherwise links should be separated by blank lines, or &lt;br> tags, or listed with bullet points, all solutions that look ugly to me.
 +
::My compromise proposal is localized Related templates:
  
...
+
:: '''3A''':
 +
::{{bc|<nowiki>{{Related articles start (简体中文)}}
 +
{{Related (简体中文)|Link A}}
 +
{{Related (简体中文)|Link B}}
 +
{{Related (简体中文)|Link C}}
 +
{{Related articles end (简体中文)}}</nowiki>}}
  
<tt>&lt;/noinclude&gt;</tt>
+
::this would also allow using localized shortcut redirects:
 +
::'''3B''':
 +
:: {{bc|<nowiki>{{Related articles start (简体中文)}}
 +
{{zh-CN shortcut|Link A}}
 +
{{zh-CN shortcut|Link B}}
 +
{{zh-CN shortcut|Link C}}
 +
{{Related articles end (简体中文)}}</nowiki>}}
  
</div>
+
::Note that the Related_articles_start/end templates should need localized versions in any case. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 15:55, 10 November 2013 (UTC)
 +
::: Is it possible to create optional second parameters for text to show. This could eliminate localized template:
 +
::: {{bc|<nowiki>{{Related links start|Start text}}
 +
{{Related|Link A (简体中文)|Link A}}
 +
{{Related|Link B (简体中文)|Link B}}
 +
{{Related|Link C (简体中文)|Link C}}
 +
{{Related links end}}</nowiki>}}
 +
::: If this can not be done, then I am OK with 3A.
 +
::: -- [[User:Fengchao|Fengchao]] ([[User talk:Fengchao|talk]]) 13:14, 11 November 2013 (UTC)
  
</div>
+
::::Ok, let's allow alternative anchors for Template:Related, but Template:Related_articles_start (better name than Template:Related_links_start) will have to have localized versions because I want to prevent anyone from using an alternative heading for purposes different than listing internal related articles. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 11:34, 12 November 2013 (UTC)
 +
::::(I don't know if I'll be able to implement this before the weekend) -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 13:52, 12 November 2013 (UTC)
  
This way every category would have a brief description, Overview templates would become unnecessary (merged with category pages), all (categorized) articles would have an almost automatic overview, and people would be more willing to categorize pages well. -- [[User:Kynikos|Kynikos]] 06:02, 5 May 2011 (EDT)
+
:::::Sorry for the late reply, I took an important test in Theoretical Physics today...
:Ok, this definitely works: see [[Template:Sandbox]], [[:Category:Sandbox]] and [[Sandbox]] for an example ('''Note that [[Template:Sandbox]] has been edited meanwhile, so the examples don't work anymore at the moment.''' -- [[User:Kynikos|Kynikos]] 08:22, 15 May 2011 (EDT)). My suggestion would be an ''Article summary category'' template, or just ''Category'' to be put among Article summary templates; note that it automatically adds the page to the category, so it doesn't even duplicate its name in the source.
+
:::::Note that the approach with [[Template:Related]] won't save you from unintended content - see [[Fonts]]. Though I completely support it, the additional description is really redundant, bad looking etc. Let's keep it as clean as possible.
:Template code:
+
:::::We should also consider keeping [[Template:Article summary heading]] (under different name of course), it is appropriately used in [[Xorg]]. Though [[Xorg]] is pretty special in this case and most of the links are already linked from the article, so I won't miss it so much if it just goes away.
<nowiki><includeonly>{{Article summary heading|Category: {{{1}}}}}</nowiki>
+
:::::-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 19:59, 13 November 2013 (UTC)
<nowiki>{{Article summary text|[[Category:{{{1}}}]]{{:Category:{{{1}}}}}}}</includeonly></nowiki>
+
  
:Usage:
+
::::::(Ok, we'll let you off this time, but remember that the ArchWiki always comes before trivial things like university exams :P Just kidding, I hope you did great!)
<s><nowiki>[[Category:My category]]</nowiki></s>
+
::::::I know that the template approach is not fool proof, but as I've written it will be effective in ''discouraging'' misuses of the floated box.
+
::::::About sub-heading templates I'm against, I don't really like exceptions, keeping it simple always pays back in the end, it will only be a matter of getting used to the new formatting.
&#123;&#123;Article summary start&#125;&#125;
+
::::::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 09:43, 14 November 2013 (UTC)
&#123;&#123;Article summary text|bla bla bla&#125;&#125;
+
&#123;&#123;Category|My category&#125;&#125;
+
&#123;&#123;Article summary heading|Other heading&#125;&#125;
+
&#123;&#123;Article summary text|bla bla bla 2&#125;&#125;
+
&#123;&#123;Article summary end&#125;&#125;
+
  
:<tt><nowiki>[[Category:My category]]</nowiki></tt> is not needed at the top of the page. -- [[User:Kynikos|Kynikos]] 09:56, 5 May 2011 (EDT)
+
:::::::OK, on second thought [[Xorg]] is just an exception and can be easily changed (the right box is almost as long as the table of contents, so slimming down will only help). Let's keep it simple. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 18:20, 14 November 2013 (UTC)  
:Of course if there's some category text that needs to be prevented from displaying in the template, it should be enclosed in <tt><nowiki><noinclude></nowiki></tt> tags (see the source of [[:Category:Sandbox]] for an example). -- [[User:Kynikos|Kynikos]] 10:42, 5 May 2011 (EDT)
+
  
::My original plan with respect to overviews was to include them on their related category pages (category summaries). I, too, thought of something similar, but realized that many existing categories are too broad. Consider [[Template:Access control overview]], which includes pages under [[:Category:Security]]. I also envision an "Encryption overview" which would fall under [[:Category:Security]]. For this to work, we would need to split [[:Category:Security]] -- not necessarily a bad thing, but I believe the template system provides more flexibility. -- [[User:Pointone|pointone]] 20:41, 10 May 2011 (EDT)
+
::::::::Right, starting work on [[#Procedure]]. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 01:40, 16 November 2013 (UTC)
  
:::All this idea was built on the assumption that if two articles need two different overviews, then they very likely belong to different categories (possibly in a parent-child relation) and vice versa: in your example there probably should be an Encryption category, child of Security. I still think that the flexibility given by the Overview template system has a (IMVHO too high) cost in terms of ease of use and maintenance, with respect to the category system, anyway as I said it was just brainstorming. -- [[User:Kynikos|Kynikos]] 08:58, 11 May 2011 (EDT)
+
=== Procedure ===
  
==See also or Related in Article Summary?==
+
Once the deprecation plan is approved, the steps for the transition are:
I think we'd better be coherent whether to keep links, references etc. either in a "See also" section at the bottom of the article, or in one (or more) boxes under the Article Summary at the top right of the article.
+
  
See also [[#Article summary templates]].
+
# [done] Create the new templates
 +
# [done] <s>Replace the documentation in all article summary and overview templates with warnings about their deprecation</s> Update the relevant Help articles: [[Help:Style]], [[Help:Template]]...
 +
# [done] <s>Update the relevant Help articles: [[Help:Style]], [[Help:Template]]...</s> Replace the documentation in all article summary and overview templates with warnings about their deprecation
 +
# [done] Update the most important articles so that they will be taken as examples by everybody (remember to link to this discussion from the edit summary)
 +
# Slowly update all the other articles, no need to rush this step; of course there's no way to do it with a bot, as there are too many variables
 +
# Delete all article summary and overview templates
  
-- [[User:Kynikos|Kynikos]] 15:15, 21 September 2011 (EDT)
+
For each article:
 +
* If there's no introduction, just use the article summary
 +
* If there are both an introduction and a summary, merge the summary into the introduction, or just delete it if completely useless
 +
* If there's an overview, either copy it in the introduction, or, better, simply replace it with related links
 +
* Restyle all the existing related links to use the new formatting
 +
* Any other type of content should be moved to the article body, for example the "See also" section
  
:This is more a reminder than other, but I'm starting to like the idea of adding the rule to keep related ArchWiki articles in the Article Summary box only, and external links in See also sections only. Well, this way the "See also" default may even be changed (with bots, don't worry!) to a non-imperative, descriptive title like "Additional resources", "External links" or something like that. -- [[User:Kynikos|Kynikos]] 07:06, 14 December 2011 (EST)
+
A list of the articles currently using an article summary box can be found at [[Special:WhatLinksHere/Template:Article summary start]]. Note that they are really a lot, use [[Special:MostLinkedTemplates]] for following the countdown.
:Also remember that many external links in summaries can be found with [[Special:WhatLinksHere/Template:Article_summary_link]]. -- [[User:Kynikos|Kynikos]] 07:41, 24 January 2012 (EST)
+
  
'''Advantages of links in See also:'''
+
-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 05:30, 10 November 2013 (UTC)
*There is more space for link descriptions
+
*It is likely one will read or skim the article before actively looking for additional reading material.  This naturally leaves the reader at the end of the article.  It is convenient for the reader in this case if links are at the end of the article. [[User:James Eder|James Eder]] 00:29, 22 September 2011 (EDT)
+
*It ''seems'' more common (elsewhere) to have links at the end of articles (when they are not inline with the rest of the text).  Following common convention it may be better from a usability perspective. [[User:James Eder|James Eder]] 00:29, 22 September 2011 (EDT)
+
*:Especially for people used to Wikipedia, which uses the same wiki software. [[User:Vadmium|Vadmium]] 11:12, 26 October 2011 (EDT).
+
*I am not sure how much we care about this but it having the links at the end could be more friendly to small form factor screens and screen readers. [[User:James Eder|James Eder]] 00:29, 22 September 2011 (EDT)
+
*As a section, "See also" gets its own TOC entry granting easy access from near the top of the article. Alternatively one may press the END key.  [[User:James Eder|James Eder]] 00:29, 22 September 2011 (EDT)
+
*More formatting options here than in summary. [[User:Emiralle|Emiralle]] 13:12, 15 October 2011 (EDT)
+
*More inclined to put external, or less closely related stuff here. [[User:Emiralle|Emiralle]] 13:12, 15 October 2011 (EDT)
+
*''See also'' section would not be skipped if you start reading the main text sequentially from the top. [[User:Vadmium|Vadmium]].
+
*''[add more advantages...]''
+
  
'''Advantages of links in Article Summary:'''
+
:May I propose an additional step between 4) and 5): include some modified version of [[Template:Out of date]] with fixed message and links to this discussion (or other relevant page) into [[Template:Article summary start]] in order to induce contribution of other people and speed up the transition. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 19:50, 13 November 2013 (UTC)
*Immediately visible
+
 
*Beyond some minor editing inconvenience, is there any real disadvantage of having the most ''interesting'' links in both locations?  It could be advantageous for the reader to have some links in both locations. [[User:James Eder|James Eder]] 00:29, 22 September 2011 (EDT)
+
::Well, this conflicts a bit with the "no hurry" clause in 5). I wouldn't like to add an invasive note, maybe we could consider adding a superscript link like "'''Summary<sup>[[Help_talk:Style/Article_summary_templates#Deprecation of summaries and overviews|1]]</sup>'''" and/or a message in [[ArchWiki:News]]. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 09:43, 14 November 2013 (UTC)
*I think putting very closely related links in the summary gives the topic more cohesion, and as James Eder said, they could be included at the bottom as well. [[User:Emiralle|Emiralle]] 13:12, 15 October 2011 (EDT)
+
 
*It would theoretically be more effective in preventing duplication of content within the wiki, as (unexperienced) editors would have a clearer view of the articles where related content could already exist (true especially with series (or "rings") of articles on the same subject). -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 02:46, 29 September 2013 (UTC)
+
:::We can wait a week (or longer) to see how things are going, do the problematic stuff ourselves and discover as much potential problems as possible etc., and then "invite" other people to help with the huge amount of simple stuff.
*''[add more advantages...]''
+
:::My point is that when the transition is in progress, at first sight there won't be any difference (assuming that [[Template:Related articles start]] will look the same as [[Template:Article summary start]]), only the updated pages will miss the Summary and Overview. If we add some deprecation note, then I'd expect at least some people to become involved.
 +
:::I'd more like some text in the link, perhaps "'''Summary<sup>[[Help_talk:Style/Article_summary_templates#Deprecation of summaries and overviews|Deprecated template]]</sup>'''" would be better. Anyway, this can be discussed when the time comes...
 +
:::-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 18:20, 14 November 2013 (UTC)
 +
 
 +
::::Of course some additional help for the simple cases would be very welcome; my intention would be not to confuse those readers who don't know/care what a template is (I suppose they are the vast majority), especially avoiding words like "deprecated", which may be associated to the piece of software discussed in the article.
 +
::::What about something like "'''Summary<sup>[[Help_talk:Style/Article_summary_templates#Deprecation of summaries and overviews|help replacing me]]</sup>'''"? Does it look very weird?
 +
::::As you note, of course there's time to refine this, we'd better get to 4) (included) by ourselves.
 +
::::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 15:12, 15 November 2013 (UTC)
 +
 
 +
:::::The current stage of the procedure is rather slow, so I think we've already reached point 5). Btw. I'm fine with "help replacing me", even if it might seem weird - we want those templates to go away, right? -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 21:56, 10 December 2013 (UTC)
 +
 
 +
::::::Fair enough, let's see how effective it is. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:51, 11 December 2013 (UTC)
 +
 
 +
:Swapped 2 and 3. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 02:42, 16 November 2013 (UTC)
 +
 
 +
:1, 2 and 3 are done, 4 can be started. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 04:36, 16 November 2013 (UTC)
 +
 
 +
::I hope that [[Arch Boot Process]] an related count as important articles, though I made a couple of silly mistakes, so the edits are by no means exemplary :(
 +
::Anyway, [[Special:WhatLinksHere/Template:Boot_process_overview]] and [[Special:WhatLinksHere/Template:Access_control_overview]] are almost empty, is it fine to just remove the overview template (English text) from localized pages? Or just replace it with the included text so that the templates can be deleted?
 +
::-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 14:34, 16 November 2013 (UTC)
 +
 
 +
:::[[Arch Boot Process]] and related are indeed important, I like what you've done there, what mistakes have you done?
 +
:::Yes, let's just hardcode [[Template:Boot_process_overview]] and [[Template:Access_control_overview]] where they're left transcluded and then I'll delete them.
 +
:::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:06, 17 November 2013 (UTC)
 +
 
 +
:::...or better, let's replace them with direct transclusions of the categories where the text actually resides. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:14, 17 November 2013 (UTC)
 +
 
 +
::::Well, [https://wiki.archlinux.org/index.php?title=Unified_Extensible_Firmware_Interface&diff=prev&oldid=283148] speaks for everything... I also screwed up several edit summaries, copying only the text without adding brackets for the link ^^. (Actually I have an excuse for this one: for this weekend I'm stuck with ''really'' slow computer and Midori browser that does not have suggestions/completions for form entries, so I had to manually copy every single summary.)
 +
::::I've taken care of [[Special:WhatLinksHere/Template:Boot_process_overview]], the template can be deleted.
 +
::::-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 11:16, 17 November 2013 (UTC)
 +
 
 +
:::::Eheh it's good to see that you strive for perfection ;) The template is deleted, good job again! -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 10:27, 18 November 2013 (UTC)
 +
 
 +
::[[Template:Networking_overview]] and [[Template:Graphical user interface overview]] can be deleted, just [[User:Pointone|Pointone]]'s userspace remains: [[Special:WhatLinksHere/Template:Networking_overview]], [[Special:WhatLinksHere/Template:Graphical_user_interface_overview]].
 +
::Well, [[Template:Graphical user interface overview]] is actually used also in [[#A crazy idea (about Summary templates, Overview templates and categories)]] in a way that changing it would compromise the discussion. I'll leave this problem to you as the originator of that discussion :)
 +
::-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 16:15, 22 November 2013 (UTC)
 +
 
 +
:::All fixed, templates terminated. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 01:10, 23 November 2013 (UTC)
 +
 
 +
{{Tip|[[Wiki Monkey]] has a plugin that facilitates changing the templates.}}
 +
 
 +
The current blocker is that some languages still don't have the [[Template:Related articles start]] translated. The languages are:
 +
Arabic
 +
Bulgarian
 +
Croatian
 +
Danish
 +
Dutch
 +
Finnish
 +
Hebrew
 +
Hungarian
 +
Indonesian
 +
Lithuanian
 +
Polish
 +
Serbian
 +
Ukrainian
 +
Either way, there is only a couple of transclusions remaining... -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 09:46, 24 July 2015 (UTC)
 +
 
 +
==== List of deprecated templates ====
 +
 
 +
* [[:Template:Article summary start]]
 +
* [[:Template:Article summary heading]]
 +
* [[:Template:Article summary link]]
 +
* [[:Template:Article summary text]]
 +
* [[:Template:Article summary wiki]]
 +
* [[:Template:Article summary end]]
 +
* <s> Template:Access control overview
 +
* Template:Boot process overview
 +
* Template:Graphical user interface overview
 +
* Template:Networking overview
 +
* Template:Package management overview</s>
 +
 
 +
Probably all their translations should be replaced too... -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 06:28, 17 November 2013 (UTC)
 +
 
 +
=== Replacing Article summaries with Related articles ===
 +
 
 +
The above discussion deprecated [[Template:Article summary start]] and related. This discussion is now directly linked from every instance of such template and explains how to perform the replacement.
 +
 
 +
====English articles====
 +
 
 +
Basically you want to go from this set of templates:
 +
 
 +
{{bc|<nowiki>{{Article summary start}}
 +
{{Article summary text|This is a short summary}}
 +
{{Article summary heading|Required software}}
 +
{{Article summary link|Name of software (version)|http://www.link2software.com/}}
 +
{{Article summary heading|Required hardware}}
 +
{{Article summary text|Name of hardware (Manufacturer)}}
 +
{{Article summary heading|Related}}
 +
{{Article summary wiki|Related article title 1}}
 +
{{Article summary wiki|Related article title 2}}
 +
{{Article summary wiki|Related article title 3}}
 +
{{Article summary end}}</nowiki>}}
 +
 
 +
To this one:
 +
 
 +
{{bc|<nowiki>{{Related articles start}}
 +
{{Related|Related article title 1}}
 +
{{Related|Related article title 2}}
 +
{{Related|Related article title 3}}
 +
{{Related articles end}}</nowiki>}}
 +
 
 +
* If the article doesn't have an introduction, use the first {{ic|<nowiki>{{Article summary text}}</nowiki>}}'s argument.
 +
* If the article already had an introduction, see if the first {{ic|<nowiki>{{Article summary text}}</nowiki>}}'s argument can be merged there.
 +
* Any other type of content should be moved to the article body, for example {{ic|<nowiki>{{Article summary link}}</nowiki>}}'s arguments should go in the "See also" section
 +
 
 +
====Non-English articles====
 +
The procedure is the same as for [[#English articles]], except that you will have to append the normal language suffix to {{ic|<nowiki>{{Related articles start}}</nowiki>}}, for example in a Danish article:
 +
 
 +
{{bc|<nowiki>{{Related articles start (Dansk)}}
 +
{{Related|Related article title 1}}
 +
{{Related|Related article title 2}}
 +
{{Related2|Related article title 3|Translated title}}
 +
{{Related articles end}}</nowiki>}}
 +
 
 +
You may need to create the translated template, for example [[Template:Related articles start (Dansk)]], by copying there the contents of [[Template:Related articles start]] and possibly translating them.
 +
 
 +
As you can see, in non-English articles it is also possible to use [[Template:Related2]], which allows to enter a translated title as a second argument.
 +
 
 +
-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 07:02, 11 December 2013 (UTC) (last edit: 12:01, 4 May 2014 (UTC))

Latest revision as of 09:47, 24 July 2015

See also or Related in Article Summary?

[Moved to Help talk:Style#See also or Related in Article Summary? -- Kynikos (talk) 04:29, 5 July 2014 (UTC)]

Deprecation of summaries and overviews

As discussed in #Original discussion, although article summaries were intended to have a different use from introductions, this difference is really too subtle to be understood by many, and this is reflected by the fact that in the vast majority of articles, if not in all of them, article summaries are misused, especially in two ways:

  • they substitute or duplicate the introduction
  • they provide a useless summary that is already evident by looking at the table of contents

Often an article summary is added only to justify the floated box in order to add related links, just click a few times on Special:Random and see for yourself.

Second, as touched on in ArchWiki:Requests#Mention UEFI boot loaders in the overview, overviews are hard to maintain and they seem an unnecessary complication, as a link to the main "overview" article would serve the purpose much better (Boot Loaders in that example), or, if an overview article is absent, an overview could be easily added to the article itself, e.g. in the introduction. Note that overviews are used very sparingly, so they can also be seen as a non-standard feature of our articles.

This discussion, therefore, intends to plan the deprecation of both article summaries and overviews, leaving the right-floated box only for related links.

Now, there would be 2 * 2 main ways to implement this:

1. Create a single Template:Related links template, that will host the links as its first argument

2. Create two templates, Template:Related links start, Template:Related links end that start and end the floated div, just like Template:Article summary start and Template:Article summary end

A. Create a Template:Related template in order to induce users to use a standard formatting

B. Allow content to be liberally added to the floated box

1A:

{{Related links|
{{Related|Link A}}
{{Related|Link B}}
{{Related|Link C}}
}}

1B:

{{Related links start}}
{{Related|Link A}}
{{Related|Link B}}
{{Related|Link C}}
{{Related links end}}

2A:

{{Related links|
[[Link A]]

[[Link B]]

[[Link C]]
}}

2B:

{{Related links start}}
[[Link A]]

[[Link B]]

[[Link C]]
{{Related links end}}

My preference goes to 1B.

I would be very strict and only allow simple internal links in the floated box, so no alternative link anchor, no link descriptions, no external links, no subheadings... That kind of links should only be used in "See also" sections. Of course any opposing opinions will be considered.

-- Kynikos (talk) 05:30, 10 November 2013 (UTC) (EDIT: Kynikos (talk) 06:30, 10 November 2013 (UTC))

My preference is 2B. It support [[fstab (简体中文)|fstab]] which is more clean. -- Fengchao (talk) 13:05, 10 November 2013 (UTC)
Good point, I didn't think of language tags. I'd prefer using a Related template in order to discourage exotic uses of the floated box, and also because otherwise links should be separated by blank lines, or <br> tags, or listed with bullet points, all solutions that look ugly to me.
My compromise proposal is localized Related templates:
3A:
{{Related articles start (简体中文)}}
{{Related (简体中文)|Link A}}
{{Related (简体中文)|Link B}}
{{Related (简体中文)|Link C}}
{{Related articles end (简体中文)}}
this would also allow using localized shortcut redirects:
3B:
{{Related articles start (简体中文)}}
{{zh-CN shortcut|Link A}}
{{zh-CN shortcut|Link B}}
{{zh-CN shortcut|Link C}}
{{Related articles end (简体中文)}}
Note that the Related_articles_start/end templates should need localized versions in any case. -- Kynikos (talk) 15:55, 10 November 2013 (UTC)
Is it possible to create optional second parameters for text to show. This could eliminate localized template:
{{Related links start|Start text}}
{{Related|Link A (简体中文)|Link A}}
{{Related|Link B (简体中文)|Link B}}
{{Related|Link C (简体中文)|Link C}}
{{Related links end}}
If this can not be done, then I am OK with 3A.
-- Fengchao (talk) 13:14, 11 November 2013 (UTC)
Ok, let's allow alternative anchors for Template:Related, but Template:Related_articles_start (better name than Template:Related_links_start) will have to have localized versions because I want to prevent anyone from using an alternative heading for purposes different than listing internal related articles. -- Kynikos (talk) 11:34, 12 November 2013 (UTC)
(I don't know if I'll be able to implement this before the weekend) -- Kynikos (talk) 13:52, 12 November 2013 (UTC)
Sorry for the late reply, I took an important test in Theoretical Physics today...
Note that the approach with Template:Related won't save you from unintended content - see Fonts. Though I completely support it, the additional description is really redundant, bad looking etc. Let's keep it as clean as possible.
We should also consider keeping Template:Article summary heading (under different name of course), it is appropriately used in Xorg. Though Xorg is pretty special in this case and most of the links are already linked from the article, so I won't miss it so much if it just goes away.
-- Lahwaacz (talk) 19:59, 13 November 2013 (UTC)
(Ok, we'll let you off this time, but remember that the ArchWiki always comes before trivial things like university exams :P Just kidding, I hope you did great!)
I know that the template approach is not fool proof, but as I've written it will be effective in discouraging misuses of the floated box.
About sub-heading templates I'm against, I don't really like exceptions, keeping it simple always pays back in the end, it will only be a matter of getting used to the new formatting.
-- Kynikos (talk) 09:43, 14 November 2013 (UTC)
OK, on second thought Xorg is just an exception and can be easily changed (the right box is almost as long as the table of contents, so slimming down will only help). Let's keep it simple. -- Lahwaacz (talk) 18:20, 14 November 2013 (UTC)
Right, starting work on #Procedure. -- Kynikos (talk) 01:40, 16 November 2013 (UTC)

Procedure

Once the deprecation plan is approved, the steps for the transition are:

  1. [done] Create the new templates
  2. [done] Replace the documentation in all article summary and overview templates with warnings about their deprecation Update the relevant Help articles: Help:Style, Help:Template...
  3. [done] Update the relevant Help articles: Help:Style, Help:Template... Replace the documentation in all article summary and overview templates with warnings about their deprecation
  4. [done] Update the most important articles so that they will be taken as examples by everybody (remember to link to this discussion from the edit summary)
  5. Slowly update all the other articles, no need to rush this step; of course there's no way to do it with a bot, as there are too many variables
  6. Delete all article summary and overview templates

For each article:

  • If there's no introduction, just use the article summary
  • If there are both an introduction and a summary, merge the summary into the introduction, or just delete it if completely useless
  • If there's an overview, either copy it in the introduction, or, better, simply replace it with related links
  • Restyle all the existing related links to use the new formatting
  • Any other type of content should be moved to the article body, for example the "See also" section

A list of the articles currently using an article summary box can be found at Special:WhatLinksHere/Template:Article summary start. Note that they are really a lot, use Special:MostLinkedTemplates for following the countdown.

-- Kynikos (talk) 05:30, 10 November 2013 (UTC)

May I propose an additional step between 4) and 5): include some modified version of Template:Out of date with fixed message and links to this discussion (or other relevant page) into Template:Article summary start in order to induce contribution of other people and speed up the transition. -- Lahwaacz (talk) 19:50, 13 November 2013 (UTC)
Well, this conflicts a bit with the "no hurry" clause in 5). I wouldn't like to add an invasive note, maybe we could consider adding a superscript link like "Summary1" and/or a message in ArchWiki:News. -- Kynikos (talk) 09:43, 14 November 2013 (UTC)
We can wait a week (or longer) to see how things are going, do the problematic stuff ourselves and discover as much potential problems as possible etc., and then "invite" other people to help with the huge amount of simple stuff.
My point is that when the transition is in progress, at first sight there won't be any difference (assuming that Template:Related articles start will look the same as Template:Article summary start), only the updated pages will miss the Summary and Overview. If we add some deprecation note, then I'd expect at least some people to become involved.
I'd more like some text in the link, perhaps "SummaryDeprecated template" would be better. Anyway, this can be discussed when the time comes...
-- Lahwaacz (talk) 18:20, 14 November 2013 (UTC)
Of course some additional help for the simple cases would be very welcome; my intention would be not to confuse those readers who don't know/care what a template is (I suppose they are the vast majority), especially avoiding words like "deprecated", which may be associated to the piece of software discussed in the article.
What about something like "Summaryhelp replacing me"? Does it look very weird?
As you note, of course there's time to refine this, we'd better get to 4) (included) by ourselves.
-- Kynikos (talk) 15:12, 15 November 2013 (UTC)
The current stage of the procedure is rather slow, so I think we've already reached point 5). Btw. I'm fine with "help replacing me", even if it might seem weird - we want those templates to go away, right? -- Lahwaacz (talk) 21:56, 10 December 2013 (UTC)
Fair enough, let's see how effective it is. -- Kynikos (talk) 06:51, 11 December 2013 (UTC)
Swapped 2 and 3. -- Kynikos (talk) 02:42, 16 November 2013 (UTC)
1, 2 and 3 are done, 4 can be started. -- Kynikos (talk) 04:36, 16 November 2013 (UTC)
I hope that Arch Boot Process an related count as important articles, though I made a couple of silly mistakes, so the edits are by no means exemplary :(
Anyway, Special:WhatLinksHere/Template:Boot_process_overview and Special:WhatLinksHere/Template:Access_control_overview are almost empty, is it fine to just remove the overview template (English text) from localized pages? Or just replace it with the included text so that the templates can be deleted?
-- Lahwaacz (talk) 14:34, 16 November 2013 (UTC)
Arch Boot Process and related are indeed important, I like what you've done there, what mistakes have you done?
Yes, let's just hardcode Template:Boot_process_overview and Template:Access_control_overview where they're left transcluded and then I'll delete them.
-- Kynikos (talk) 06:06, 17 November 2013 (UTC)
...or better, let's replace them with direct transclusions of the categories where the text actually resides. -- Kynikos (talk) 06:14, 17 November 2013 (UTC)
Well, [1] speaks for everything... I also screwed up several edit summaries, copying only the text without adding brackets for the link ^^. (Actually I have an excuse for this one: for this weekend I'm stuck with really slow computer and Midori browser that does not have suggestions/completions for form entries, so I had to manually copy every single summary.)
I've taken care of Special:WhatLinksHere/Template:Boot_process_overview, the template can be deleted.
-- Lahwaacz (talk) 11:16, 17 November 2013 (UTC)
Eheh it's good to see that you strive for perfection ;) The template is deleted, good job again! -- Kynikos (talk) 10:27, 18 November 2013 (UTC)
Template:Networking_overview and Template:Graphical user interface overview can be deleted, just Pointone's userspace remains: Special:WhatLinksHere/Template:Networking_overview, Special:WhatLinksHere/Template:Graphical_user_interface_overview.
Well, Template:Graphical user interface overview is actually used also in #A crazy idea (about Summary templates, Overview templates and categories) in a way that changing it would compromise the discussion. I'll leave this problem to you as the originator of that discussion :)
-- Lahwaacz (talk) 16:15, 22 November 2013 (UTC)
All fixed, templates terminated. -- Kynikos (talk) 01:10, 23 November 2013 (UTC)
Tip: Wiki Monkey has a plugin that facilitates changing the templates.

The current blocker is that some languages still don't have the Template:Related articles start translated. The languages are:

Arabic
Bulgarian
Croatian
Danish
Dutch
Finnish
Hebrew
Hungarian
Indonesian
Lithuanian
Polish
Serbian
Ukrainian

Either way, there is only a couple of transclusions remaining... -- Lahwaacz (talk) 09:46, 24 July 2015 (UTC)

List of deprecated templates

Probably all their translations should be replaced too... -- Kynikos (talk) 06:28, 17 November 2013 (UTC)

Replacing Article summaries with Related articles

The above discussion deprecated Template:Article summary start and related. This discussion is now directly linked from every instance of such template and explains how to perform the replacement.

English articles

Basically you want to go from this set of templates:

{{Article summary start}}
{{Article summary text|This is a short summary}}
{{Article summary heading|Required software}}
{{Article summary link|Name of software (version)|http://www.link2software.com/}}
{{Article summary heading|Required hardware}}
{{Article summary text|Name of hardware (Manufacturer)}}
{{Article summary heading|Related}}
{{Article summary wiki|Related article title 1}}
{{Article summary wiki|Related article title 2}}
{{Article summary wiki|Related article title 3}}
{{Article summary end}}

To this one:

{{Related articles start}}
{{Related|Related article title 1}}
{{Related|Related article title 2}}
{{Related|Related article title 3}}
{{Related articles end}}
  • If the article doesn't have an introduction, use the first {{Article summary text}}'s argument.
  • If the article already had an introduction, see if the first {{Article summary text}}'s argument can be merged there.
  • Any other type of content should be moved to the article body, for example {{Article summary link}}'s arguments should go in the "See also" section

Non-English articles

The procedure is the same as for #English articles, except that you will have to append the normal language suffix to {{Related articles start}}, for example in a Danish article:

{{Related articles start (Dansk)}}
{{Related|Related article title 1}}
{{Related|Related article title 2}}
{{Related2|Related article title 3|Translated title}}
{{Related articles end}}

You may need to create the translated template, for example Template:Related articles start (Dansk), by copying there the contents of Template:Related articles start and possibly translating them.

As you can see, in non-English articles it is also possible to use Template:Related2, which allows to enter a translated title as a second argument.

-- Kynikos (talk) 07:02, 11 December 2013 (UTC) (last edit: 12:01, 4 May 2014 (UTC))