Template talk:Documentation

I propose to add " clear: both; border: 2px dotted #666666; padding: 0.6em; background-color: #f5f5f5;" to the style tag of the first div. That would make the documentation template be easier to distuingish from the actual content of the containing template. That's standard on all Wikipedias using Template:Documentation. --Slomox (talk) 21:14, 17 January 2009 (UTC)

It would be nice if this version of the template could take over some of the features of the English wikipedia version. Especially the sandbox and testcases detection is highly useful for editors. Although perhaps it should be at the bottom of the template, and not at the top. I also think we should remove the "view" option, like they have done on en.wp. It's not really useful. A selflink indentation on "This documentation is transcluded" part might be useful as well. TheDJ (talk) 21:31, 14 September 2009 (UTC)

As I had some troubles with the template for /doc subpages, I wrote a description an just inserted standard section header(s). Currently one needs to insert a blank line before the first section header, otherwise the header appears unformatted, e.g. as == Usage ==. -- User:Docu at 17:15, 21 April 2010 (UTC)

Hi. I looked for ways that this template is translated so it must be auto-translated {{{Autotranslate|1={{{1|}}}|2={{{2|}}}|base=documentation}}. Can anyone say if you can? Thanks--Diego Sanguinetti (talk) 17:59, 16 July 2010 (UTC)

Support This is needed to get some template docs work. Please add it. --Rezonansowy (talk) 16:36, 14 February 2015 (UTC)

What exactly does not work with the template as of now? And it would be kind if you could post a sample of what you expect that I or the admin fulfilling this request can history merge or copy&paste with this or into this template. -- Rillke(q?) 16:41, 14 February 2015 (UTC)

@Rillke: Hi, the template version on Commons lacks the {{{content}}} parameter which is used to embed doc context on template page (same page for transluction). I suggest to sync it with the last revision before the transition to Lua. It contains this parameter and some others, which are helpful in many tasks. The appearance of this template should be same or at least similar on every Wikimedia wiki, I think. There're some good sample on en.wiki doc – en:Template:Documentation#Usage. --Rezonansowy (talk) 21:51, 14 February 2015 (UTC)

@Rezonansowy: Neglecting the fact that on Commons, there is a translation system, it would be possibly look similar. What I'd like to know is what the Content parameter would be useful for. I understood what it does but on Commons, you can expect a lot of edits to template documentation as it has to be translated. So a separate page is favourable in most circumstances. However, if you convince me that this assumption is too narrow, no problem, then I'll see what I can do (including amending zillions of subpages for keeping i18n support). -- Rillke(q?) 22:06, 14 February 2015 (UTC)

@Rillke: OK, I'll show where I want to use it. I'd like to use {{Source template doc}} to got same apperance like on {{Wellcome Images}}. There's one doc template for all Source templates, but the present implementation of {{Documentation}} (our template) lacks the needed parameter and prevents me to to this well. With {{{content}}} it would be possible to create a documentation with a full translation with parameters template inside. That's why this parameter is needed. Basically, I need the ability to wrap custom text into the {{Documentation}} on the same page. And this feature is present already on en.wiki. Example:

<!--Last line of your template code--><noinclude>
{{Documentation
| content =
{{Source template doc|desc=Images bearing this tag are placed in the category [[:Category:Images from Animalandia|Images from Animalandia]].
Most images from Animalandia are published under {{tl|GPL-3}}, but some are published under a Creative Commons License including the non-free {{tl|cc-by-nc-sa}}, which is not suitable for commons. See [http://herramientas.educa.madrid.org/animalandia/aviso-legal.php Aviso legal].}}}}
</noinclude>

Mhm, sorry I still don't get the point why one can't place what is intended to pass to the content= parameter on the documentation subpage (Template:Lorumipsumdolor/doc, e.g. replacing Template:Wellcome Images/doc's content with {{Source template doc|desc=This tag places images in the category [[:Category:Files from Wellcome Images|Files from Wellcome Images]].}}) instead. -- Rillke(q?) 13:19, 16 February 2015 (UTC)

That's because we don;t want to create a /doc subpage for every template. --Rezonansowy (talk) 19:53, 16 February 2015 (UTC)

What kind of advantage to you expect by managing the template and its documentation in one page? -- Rillke(q?) 20:24, 16 February 2015 (UTC)

Less mess. I think it is time to make this parameter live on Commons. --Rezonansowy (talk) 23:33, 16 February 2015 (UTC)

┌─────────────────────────────────┘Rezonansowy, it sounds like you are trying to create page similar to Template:GeoName/doc where one documentation template is used for over 1000 templates (without /doc subpage), or Template:Creator/documentation (used for 19k creator templates). I am still a little shaky on the purpose of "Content" as defined on English wikipedia, but from what I gathered you want to use it in order to pass a parameter or parameters to {{Source template doc}}, so the content of the documentation is created by {{Source template doc|1=...|2=...}} template. I can see that being useful. Documentation templates Template:GeoName/doc and Template:Creator/documentation only required template name which was provided by {{PAGENAME}}, but other documentation templates might require more parameters. --Jarekt (talk) 04:31, 17 February 2015 (UTC)

It's no nonsense, if it allows to display inline documentation with the look and feel of a /doc subpage. On m:Template:Documentation/doc there was still an esoteric Caveat about one additional transclusion (of the /doc subpage) that could be one transclusion too much. But I've never seen that outside of Patrick's hardcore tests, therefore I removed the Caveat on Meta. Meta is still at the last state without content=, maybe add it there, too, if it is useful for any copy+paste or import/export transwiki. –Be..anyone (talk) 01:05, 23 April 2015 (UTC)

Is "purge" really not translated anywhere, or is it a problem on my side (I tested de es fr), or a problem on Meta with system messages only available here? I copied some languages as is today (de es fr pl pt ru), but stopped it, because it would be pointless if all languages (notably with other scripts, el ja ru uk zh etc.) will get updated translations "soon" here. –Be..anyone (talk) 01:05, 23 April 2015 (UTC)