Template:Link/doc

{	"params": { "1": {			"label": "Link", "description": "Internal page link", "example": "Kernel", "type": "string", "required": true },		"2": {			"label": "Alternate text", "description": "Optional text to replace the page name; use for translations and other context", "example": "Gentoo's Kernel information", "type": "string", "suggested": true },		"section": { "aliases": [ "anchor" ],			"description": "A section of an internal link with a preceding # to designate an anchor", "example": "#Usage", "type": "string" }	},	"description": "Link to a page that can automatically point to a translated page if it exists", "format": "inline" }

Use this template to create an internal link. The template rewrites the link to link to the same language subpage of the target page as the language subpage of the source page, if existing. Else fallback to the English version.

Rationale
On translated pages you have the following problem with internal links. E.g. you want to link the article "Foo" and the translation of "Foo" doesn't exists right now. You can:
 * link the English page of "Foo".
 * Pro: You link to an available guide.
 * Contra: Later, when "Foo" gets translated, you're guiding the reader to an English page. There he has to select his language again. To save the reader from this hassle, you have to change all links to "Foo" in all translated pages.


 * link the translated page of "Foo" (right now not existing).
 * Pro: Later, when "Foo" gets translated, you're guiding the reader to the translated page.
 * Contra: Until "Foo" gets translated, you're pointing to an non-existing page. The readers has to get active, to even get to the English page.

This template solves this problem.