Blooncyclopedia:Style guide: Difference between revisions

Line 81:

==Linking==

*In general, ~~articles should~~ only ~~be linked to once in~~ a ~~single page, though links can be repeated if in a section much later~~ in ~~the~~ article. If the word "monkey" is used 10 times in a page, then only the first occurrence of the word should be ~~linked, and maybe~~ a ~~later one too if the article~~ is ~~long and has multiple~~ major ~~sections~~.

*In general, only insert a link the first time the term appears in an article. If the word "monkey" is used 10 times in a page, then only the first occurrence of the word should be a link. Repeating links is acceptable on longer articles, but try to limit it to once per major section (level 2 headings).

*In the source editor, try to optimize links as much as possible. For example, you can use <code><nowiki>[[Monkey]]</nowiki>s</code> instead of <code><nowiki>[[Monkey|Monkeys]]</nowiki></code> to render the link text in plural form. (See [[Help:Links]] for more information.)

**If you need to link to a subsection and it has a redirect, just link to the redirect instead of using a piped link. For example, use <code><nowiki>[[Paragon power]]</nowiki></code> instead of <code><nowiki>[[Paragon#Power|Paragon power]]</nowiki></code> when linking to the section about Paragon power. That way, the link doesn't need to be updated in case the section is split into its own article at a later point.

*Avoid having multiple links directly adjacent to each other (what's called a "sea of blue"). For example, <code><nowiki>[[Camo Bloon|Camo]] [[Ceramic Bloon|Ceramic]] [[Bloon]]</nowiki></code> ([[Camo Bloon|Camo]] [[Ceramic Bloon|Ceramic]] [[Bloon]]) makes it difficult to tell at a glance that each word links to a separate article. Two adjacent links is acceptable, but ~~any~~ more than that ~~is excessive~~. Consider using more specific links (e.g., <code><nowiki>[[Camo Bloon|Camo]] [[Ceramic Bloon]]</nowiki></code>) or rephrasing the article to introduce one of the links earlier.

*Avoid having multiple links directly adjacent to each other in article text (what's called a "sea of blue"). For example, <code><nowiki>[[Camo Bloon|Camo]] [[Ceramic Bloon|Ceramic]] [[Bloon]]</nowiki></code> ([[Camo Bloon|Camo]] [[Ceramic Bloon|Ceramic]] [[Bloon]]) makes it difficult to tell at a glance that each word links to a separate article. Two adjacent links is acceptable, but anything more than that should be revised. Consider using more specific links (e.g., <code><nowiki>[[Camo Bloon|Camo]] [[Ceramic Bloon]]</nowiki></code>) or rephrasing the article to introduce one of the links earlier.

==Foreign languages==

@@ Line 81: / Line 81: @@
 ==Linking==
-*In general, articles should only be linked to once in a single page, though links can be repeated if in a section much later in the article. If the word "monkey" is used 10 times in a page, then only the first occurrence of the word should be linked, and maybe a later one too if the article is long and has multiple major sections.
+*In general, only insert a link the first time the term appears in an article. If the word "monkey" is used 10 times in a page, then only the first occurrence of the word should be a link. Repeating links is acceptable on longer articles, but try to limit it to once per major section (level 2 headings).
 *In the source editor, try to optimize links as much as possible. For example, you can use <code><nowiki>[[Monkey]]</nowiki>s</code> instead of <code><nowiki>[[Monkey|Monkeys]]</nowiki></code> to render the link text in plural form. (See [[Help:Links]] for more information.)
 **If you need to link to a subsection and it has a redirect, just link to the redirect instead of using a piped link. For example, use <code><nowiki>[[Paragon power]]</nowiki></code> instead of <code><nowiki>[[Paragon#Power|Paragon power]]</nowiki></code> when linking to the section about Paragon power. That way, the link doesn't need to be updated in case the section is split into its own article at a later point.
-*Avoid having multiple links directly adjacent to each other (what's called a "sea of blue"). For example, <code><nowiki>[[Camo Bloon|Camo]] [[Ceramic Bloon|Ceramic]] [[Bloon]]</nowiki></code> ([[Camo Bloon|Camo]] [[Ceramic Bloon|Ceramic]] [[Bloon]]) makes it difficult to tell at a glance that each word links to a separate article. Two adjacent links is acceptable, but any more than that is excessive. Consider using more specific links (e.g., <code><nowiki>[[Camo Bloon|Camo]] [[Ceramic Bloon]]</nowiki></code>) or rephrasing the article to introduce one of the links earlier.
+*Avoid having multiple links directly adjacent to each other in article text (what's called a "sea of blue"). For example, <code><nowiki>[[Camo Bloon|Camo]] [[Ceramic Bloon|Ceramic]] [[Bloon]]</nowiki></code> ([[Camo Bloon|Camo]] [[Ceramic Bloon|Ceramic]] [[Bloon]]) makes it difficult to tell at a glance that each word links to a separate article. Two adjacent links is acceptable, but anything more than that should be revised. Consider using more specific links (e.g., <code><nowiki>[[Camo Bloon|Camo]] [[Ceramic Bloon]]</nowiki></code>) or rephrasing the article to introduce one of the links earlier.
 ==Foreign languages==