Wikipedia talk:Template documentation/Archive 1: Difference between revisions

Revision as of 02:08, 6 August 2009

Latest revision as of 03:33, 26 September 2021

(2 intermediate revisions by 2 users not shown)

Line 217:

I think that {{tl|template doc}} is a bit to "in your face". It makes the documentation hard to read. It is too colourful and doesn't match the Wikipedia colour scheme. The image [[Image:Template-info.svg|35px]] is cute but adds to the overall "information stress" of the design. And the horizontal line immediately under the title also is unnecessary. Especially since below that normally is transcluded in the sentence "''This documentation is transcluded from Template:X/doc. (edit | history)''" surrounded by two horizontal lines. Sure, without all that decoration it looks more boring, but the point is to make the documentation readable, not to pimp or template pages as much as possible. --[[User:Davidgothberg|David Göthberg]] 10:49, 10 August 2007 (UTC)

:I somewhat concur with your opinions regarding the background colours, and I'd prefer a less invasive design. One suggestions is to not include {{tl|template doc}}, since it isn't required and was added to this template page recently, in the 2007-06-04T07:33:23 revision by [[User:Chochopk]]. [[Template:Coor dms|Here]] is an example of a template that doesn't use it. You may also suggest to redesign {{tl|Template doc inline}} to remove boarders and change colors (i.e., replace <code>style="background-color:#ecfcf4; border:1px solid #aaa;</code> with <code>style="background-color:transparent; border:none;</code>, or something like that.) <ttsamp>+[[User:Mwtoews|<fontspan colorstyle="color:#008000;">m</span>]][[User talk:Mwtoews|m]]</font><fontspan colorstyle="color:#6B3FA0;">[[User talk:Mwtoews|t]]</fontspan>]]</ttsamp> 15:18, 10 August 2007 (UTC)

::Thanks for the complete answer! Yes, when I first encountered this kind of subpage docs they were without boxes and just had the thin {{tl|template doc page transcluded}} header. And the first time I used this kind of subpage docs myself that was what I used. But I like having the transcluded documentation surrounded by some kind of box so it is clear what is the transcluded part. And yes, I am aware that the colours etc in this case are coded in {{tl|Template doc inline}}. I just wanted to say my "complaints" in an as easy to understand way as possible for everyone. I thought it was better to bring that discussion up here since this is kind of the "project page" for those templates, right? And sure, I can design my own boxes. But I thought I didn't want to add more box templates and instead first discuss it here. Oh, I seem to remember there are some ready made simple grey/blue generic box templates. They could be used for this. But they of course lacks the view and edit buttons. --[[User:Davidgothberg|David Göthberg]] 16:11, 10 August 2007 (UTC)

Line 228:

| style="background:#ecf8fc;border:1px solid #aaa;" | Blue-er: #ecf8fc;

|}

:::I'm not sure how to deal with the horizontal lines in {{tl|template doc page transcluded}} ("transcluded") right now, since it is used with/without {{tl|template doc}} ("tdoc"). It would be nice to have the "tdoc" functionality included in the "transcluded" template, however then all template instances of "tdoc" would have to be edited manually or by a bot to remove the "transcluded" instance. The "transcluded" template would then be used for older template documents. Could this work? It would mean a bit of work, of course. <ttsamp>+[[User:Mwtoews|<fontspan colorstyle="color:#008000;">m</span>]][[User talk:Mwtoews|m]]</font><fontspan colorstyle="color:#6B3FA0;">[[User talk:Mwtoews|t]]</fontspan>]]</ttsamp> 17:24, 10 August 2007 (UTC)

Oh, I forgot that most people use LCD screens nowadays. Then more colours are needed. (I use CRT screens.) So don't bother about the colour. The only changes I would like then is that we remove the image and the horizontal border under the {{tl|template doc inline}} header. No other changes needed to make the template much less "invasive". And that should not "break" any of the old pages that only use one of the two templates.

Line 237:

<div style="font-size: 1.5em;">{{#if:Template documentation|<span class="editsection" style="font-size: small">[<span class="plainlinks">[{{fullurl:Template documentation }} view]</span>] [<span class="plainlinks">[{{fullurl:Wikipedia talk:Template documentation|action=edit&preload={{urlencode:Template:Template doc/Preload}}}} edit]</span>]</span>}}<span class="mw-headline">Template documentation</span></div>

{{Documentation subpage}}

{{template doc page transcluded}}

This template bla bla bla...

</div>

Line 315:

==Merge of documentation templates==

I'd like to draw some attention towards a proposed merge between {{tl|Template doc}} and {{tl|Documentation}}. Comment here: [[Template talk:Template doc#Merge Template:Documentation and Template:Template doc]]. <ttsamp>+[[User:Mwtoews|<fontspan colorstyle="color:#008000;">m</span>]][[User talk:Mwtoews|m]]</font><fontspan colorstyle="color:#6B3FA0;">[[User talk:Mwtoews|t]]</fontspan>]]</ttsamp> 08:11, 7 October 2007 (UTC)

:The merge took place. {{tl|Documentation}} won. --[[User:AlastairIrvine|AlastairIrvine]] ([[User talk:AlastairIrvine|talk]]) 16:09, 9 March 2008 (UTC)

Line 337:

[http://en.wikipedia.org/w/index.php?title=Wikipedia:Template_documentation&oldid=128847413 this] and the current page bear virtually no resemblance to the purpose of the original page Template doc page pattern page. 'this' itself may have lost some of the information... that is now totally obscured by what is here on "Template documentation".

<s>Someone needs to restore the original content and split the history and original page name</s>[http://en.wikipedia.org/w/index.php?title=WP:DPP&oldid=105215046]. [[WP:DPP]] was the original mnemonic shortcut so that can be kept with the resurrected page, but the "Template documentation" page as it currently stands is not the technical method the original page was written to be. If the information is there at all, it is well hidden. I see no link to the talk discussion involving Tim!, CDB, and then Liguleum. <br /><br />http://en.wikipedia.org/wiki/Wikipedia:Template_doc_page_pattern [Ah, what the hell -- I restored the page from the Meta copy plus a better intro. Let it be the "Here's why we do this" page it was written to be, and you guys do whatever this page does.] <br /><br />As I was the person pressing for 'displayed' documentation that lead to the (questions of Tim... that lead to the...) development of this method by CBDunkerson (just over a year ago!), I've no problem with you guys standardizing and cleaning up template documentation--it is in fact one of the stated purposes when I started the [[WP:TSP]] project. <br /><br />But I have a major problem that your renamed page lost the reasons for doing the method, and morphed into a spoon-feeding of naif editors, vice a clear method for the technically savvy. <br /><br />Feel free to hijack that 'TSP' and rename to "template standardization project" or some such, but this former technical reference needs restored. Best regards, // <b>[[User:Fabartus|Fra]]</b><font color="green">[[User talk:Fabartus|<span style="color:green;">nkB]]</fontspan>]] 21:07, 12 October 2007 (UTC)