Template talk:Template doc

Template:Template doc is permanently protected from editing because it is a heavily used or highly visible template. Substantial changes should first be proposed and discussed here on this page. If the proposal is uncontroversial or has been discussed and is supported by consensus, editors may use {{edit template-protected}} to notify an administrator or template editor to make the requested edit. Usually, any contributor may edit the template's documentation to add usage notes or categories.

Any contributor may edit the template's sandbox. Functionality of the template can be checked using test cases.

This is the talk page of a redirect that has been merged and now targets the page:
• Template:Documentation
Because this page is not frequently watched, present and future discussions, edit requests and requested moves should take place at:
• Template talk:Documentation
Merged page edit history is maintained in order to preserve attributions.

Purpose

This template is intented to be used to visually harmonize the documentation in the various templates using the WP:DOC /doc subpage paradigm. —Quarl ^(talk) 2007-03-09 04:19Z

Thank you, nice work. — Hex (❝?!❞) 13:17, 17 March 2007 (UTC)[reply]

I really like it! It does indeed appear visually appealing. --Iamunknown 18:53, 16 April 2007 (UTC)[reply]

Excellent man! --Andersmusician $ 20:46, 15 May 2007 (UTC)[reply]

This really is a good idea. It's alot easier to read the template if the "doc" section is split onto its own subpage. Timneu22 11:33, 16 May 2007 (UTC)[reply]

Deprecates old way?

Does this mean that {{{{FULLPAGENAME}}/doc}} is totally deprecated? — Omegatron 23:44, 23 July 2007 (UTC)[reply]

Yes. This new solution is much better and looks much better. --David Göthberg 07:42, 18 September 2007 (UTC)[reply]

Editprotected to finish merge tagging, and to fork template into template code and doc page per its own purpose (d'oh).

Please add:

<noinclude>{{Mergeto:Documentation|{{subst:DATE}}}}</noinclude>

to the top of the documentation of this template (i.e. under the template code itself); someone has created and is deploying another system of template documentation templates, and now we have a sensless situation of competition between two sets of templates that functionally do precisely the same thing. I find it unbelievable ironic that this template's own documentation is not using its own advice and having the template and the documentation separated, thus necessitating this editprotected request. SO, please also fork this page into the template code and the documentation /doc subpage so this won't ever have to be editprotected for any reason other than changes to the template's actual code. — SMcCandlish [talk] [cont] ‹(-¿-)› 05:17, 2 October 2007 (UTC)[reply]

There is a doc page. For clarity I have split up the code into an includeonly and noinclude part, so that the latter is standard.--Patrick 08:06, 2 October 2007 (UTC)[reply]

Merge Template:Documentation and Template:Template doc

The following discussion is closed. Please do not modify it. Subsequent comments should be made in a new section.

The result was merge into Template:Documentation with the merge talk page designated as Template talk:Documentation. -- Conrad T. Pino 07:23, 6 November 2007 (UTC)[reply]

Proposed by User:SMcCandlish.

Merge to ~~{{Template doc}}~~ {{Documentation}}: There should probably be only one of these templates, and I prefer {{Template doc}}, since it is slightly more compact, it doesn't include confusing jargon (i.e., "transcluded"), and has the ability to "preload" a doc page (very nice feature). However, I do like the {{documentation}} namespace better, since this doesn't need to be used exclusively with templates. +mt 07:58, 7 October 2007 (UTC)[reply]

I did not propose it, I just fixed an error in the tag. Anyway, I support it. Preload works for both templates.--Patrick 09:32, 7 October 2007 (UTC)[reply]

(sorry ... fixed the nominator) +mt 18:21, 7 October 2007 (UTC)[reply]

See my sandbox for a comparison between {{template doc}} and {{documentation}} (essentially a list of improvements). —{admin} Pathoschild 04:04:00, 09 October 2007 (UTC)

This discussion seems rather stagnant. I think {{documentation}} is clearer and it doesn't use an abbreviation. Also, {{documentation}} uses better code. I vote to merge {{template doc}} into {{documentation}}. --MZMcBride 18:54, 13 October 2007 (UTC)[reply]

Agree — we can always merge any missing features from {{template doc}} in the future. So I guess convert {{template doc}} into a redirect to {{documentation}} ? +mt 19:43, 13 October 2007 (UTC)[reply]

support We need only one way to do this. --Gadget850 ( Ed) 17:21, 22 October 2007 (UTC)[reply]

Support: I agree with the proposal to keep {{Documentation}} and remove the other variant for aesthetic reasons as well as functional reasons. I have worked with all the succession templates and have been adding /doc pages to all of them, and after considerable thought, enjoy the first option much better, although I agree that the second does have some handy features. Keep the pretty one, merge the good features of the ugly one. 'Tis all!
–Darius von Whaleyland, Great Khan of the Barbarian Horde 23:48, 22 October 2007 (UTC)[reply]

Support: Keep it at {{Documentation}}—the less templates for this purpose, the better. Perhaps there can be a {{Documentation/template}} subpage option for specifying the template namespace (this method could also be applied to other name spaces). Or this can be built into the original, provided someone here has strong Wiki-fu to alter the template display based on its namespace. —Down10 ^TACO 21:51, 3 November 2007 (UTC)[reply]

Support: Keep {{Documentation}}. No need for multiple methods provided the function is equivalent. I've been reading both and finding significant behavior differences indicating lengthy discussion. Where and how shall we discuss the issues and determine consensus? – Conrad T. Pino 16:54, 4 November 2007 (UTC)[reply]

Closure: The merge was proposed 2007-10-07 and there are no dissents. Shall the close the proposal and move on to implentation? – Conrad T. Pino 17:06, 4 November 2007 (UTC)[reply]

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

Parameters

What is the purpose of the two parameters {{{1}}} and {{{2}}}? 16@r 23:09, 7 October 2007 (UTC)[reply]

There is only one: 1 = name of the documentation page.--Patrick 23:19, 7 October 2007 (UTC)[reply]

This template's heading

This template previously implemented the classic "(icon) Template documentation" heading but now implements the default {{Documentation}} heading. This change is part of the {{Documentation, template}}'s final fate discussion. – Conrad T. Pino (talk) 18:51, 18 November 2007 (UTC)[reply]

Broken?

I haven't been following the merge discussion, but I've noticed that yesterday's changes to this template appear to have broken it. See for example Template:Citation or Template:Infobox Football biography - doc subpages exist but aren't displayed properly any more. If this isn't a transitory thing I'd suggest reverting to the last functional version of this template. Bryan Derksen (talk) 09:44, 25 November 2007 (UTC)[reply]