This is the talk page for discussing improvements to the Template documentation page. |
|
Archives: 1, 2Auto-archiving period: 90 days |
Wikipedia Help Project | (Rated NA-class, High-importance) | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Nowadays, TemplateData is included in all the templates and it is a good procedure filling its parameters in the documentation, so it would be good including a link to Wikipedia:TemplateData/Tutorial in the lead section. --BoldLuis (talk) 10:09, 3 May 2020 (UTC)
{{documentation}} would be included by default in all the templates, excepting when {{noincdoc}} (or similar code) is used (I think there is no reason to exclude documentation in templates anyway).
The same for the TemplateData content, including its template detected parameters, when the documentation page is automatically created (just after template creation). --BoldLuis (talk) 11:08, 3 May 2020 (UTC)
I had a need for a way to highlight param values on template doc pages, which could not easily be achieved by use of the <code> tag, which I had been using previously. The use case was the documentation for {{Lorem ipsum}}, which has some parameters whose values may contain leading and trailing blanks; needless to say, it's particularly hard to see those. An example is: * "
. The new template {{param value}} was my attempted solution for this problem. You can see some examples of it in use at Template:Lorem ipsum#Prefix and suffix whitespace. Mathglot (talk) 10:32, 8 August 2021 (UTC)
This page doesn't say where or how to put the TemplateData, even though many many templates use a standard format (seen below). I suggest this page include it in the #Manual creation section, and in the prefilled creation link provided by {{documentation}}, and putting it at the very bottom of the documentation subpage. There was also a discussion nearly 8 years ago on what a standard should be, for those curious. Adding the templatedata section can remind and encourage editors to add it for use in the VisualEditor. Agree? Disagree? Thoughts?
== TemplateData == {{TemplateData header}} <templatedata> ... </templatedata>