<tdstyle="border-bottom: 1px solid #c0c090; font-weight: bold;">This is the <arel="mw:WikiLink"href="./Wikipedia:Talk_page_guidelines"title="Wikipedia:Talk page guidelines">talk page</a> for discussing improvements to the <arel="mw:WikiLink"href="./Wikipedia:Template_documentation"title="Wikipedia:Template documentation">Template documentation</a> page.<br/></td>
</tr>
<tr>
<td>
<divclass="talkheader-body">
<divclass="talkheader-help">
<ul><li>Put new text under old text. <strong><arel="mw:WikiLink"href="./Special:NewSection/Wikipedia_talk:Template_documentation"title="Special:NewSection/Wikipedia talk:Template documentation">Click here to start a new topic.</a></strong></li>
<li><arel="mw:WikiLink"href="./Wikipedia:Signatures"title="Wikipedia:Signatures">Sign your posts</a> by typing four tildes <spanclass="nowrap">(<code>~~~~</code>)</span>.</li>
<li>New to Wikipedia? Welcome! <arel="mw:WikiLink"href="./Help:Introduction"title="Help:Introduction">Learn to edit</a>; <arel="mw:WikiLink"href="./Wikipedia:Questions"title="Wikipedia:Questions">get help</a>.</li></ul>
</div>
<divclass="talkheader-policies">
<ul><li><arel="mw:WikiLink"href="./Wikipedia:Assume_good_faith"title="Wikipedia:Assume good faith">Assume good faith</a></li>
<li><arel="mw:WikiLink"href="./Wikipedia:Civility"title="Wikipedia:Civility">Be polite</a> and <arel="mw:WikiLink"href="./Wikipedia:No_personal_attacks"title="Wikipedia:No personal attacks">avoid personal attacks</a></li>
<li><arel="mw:WikiLink"href="./Wikipedia:Please_do_not_bite_the_newcomers"title="Wikipedia:Please do not bite the newcomers">Be welcoming to newcomers</a></li>
<li>Seek <arel="mw:WikiLink"href="./Wikipedia:Dispute_resolution_requests"title="Wikipedia:Dispute resolution requests">dispute resolution</a> if needed</li></ul>
</div>
</div>
</td>
</tr><tr><tdstyle="border-top: 1px solid #c0c090; padding: 1px 3px;"><b><arel="mw:WikiLink"href="./Help:Archiving_a_talk_page"title="Help:Archiving a talk page">Archives</a>:</b><arel="mw:WikiLink"href="./Wikipedia_talk:Template_documentation/Archive_1"title="Wikipedia talk:Template documentation/Archive 1">1</a>, <arel="mw:WikiLink"href="./Wikipedia_talk:Template_documentation/Archive_2"title="Wikipedia talk:Template documentation/Archive 2">2</a><spanstyle="position: relative; top: 2px; float: right; font-size: 90%;"><styledata-mw-deduplicate="TemplateStyles:r1038841319"typeof="mw:Extension/templatestyles"about="#mwt8"data-mw='{"name":"templatestyles","attrs":{"src":"Template:Tooltip/styles.css"}}'>.mw-parser-output.tooltip-dotted{border-bottom:1pxdotted;cursor:help}</style><spantitle="Discussions with timestamps are automatically archived by lowercase sigmabot III after 90 days of inactivity."class="rt-commentedText tooltip tooltip-dotted "about="#mwt10"typeof="mw:ExpandedAttrs"data-mw='{"attribs":[[{"txt":"title"},{"html":"<span typeof=\"mw:Nowiki\" data-parsoid=\"{}\">Discussions with timestamps are automatically archived by lowercase sigmabot III after 90<span typeof=\"mw:Entity\" data-parsoid='{\"src\":\"&amp;nbsp;\",\"srcContent\":\" \"}'> </span>days of inactivity.</span>"}]]}'>Auto-archiving period</span>: <b>90<spantypeof="mw:Entity"></span>days</b><spantypeof="mw:Entity"></span><spantypeof="mw:Image"><ahref="./Help:Archiving_a_talk_page#Automated_archiving"><imgalt=""resource="./File:Information_icon4.svg"src="//upload.wikimedia.org/wikipedia/en/thumb/1/1d/Information_icon4.svg/16px-Information_icon4.svg.png"decoding="async"data-file-width="620"data-file-height="620"data-file-type="drawing"height="16"width="16"srcset="//upload.wikimedia.org/wikipedia/en/thumb/1/1d/Information_icon4.svg/24px-Information_icon4.svg.png 1.5x, //upload.wikimedia.org/wikipedia/en/thumb/1/1d/Information_icon4.svg/32px-Information_icon4.svg.png 2x"/></a></span></span></td>
<tdclass="mbox-image"style="padding:2px 0;"><spantypeof="mw:Image"><ahref="./File:Question_book_magnify2.svg"><imgalt="WikiProject icon"resource="./File:Question_book_magnify2.svg"src="//upload.wikimedia.org/wikipedia/commons/thumb/a/ab/Question_book_magnify2.svg/50px-Question_book_magnify2.svg.png"decoding="async"data-file-width="60"data-file-height="60"data-file-type="drawing"height="50"width="50"srcset="//upload.wikimedia.org/wikipedia/commons/thumb/a/ab/Question_book_magnify2.svg/75px-Question_book_magnify2.svg.png 1.5x, //upload.wikimedia.org/wikipedia/commons/thumb/a/ab/Question_book_magnify2.svg/100px-Question_book_magnify2.svg.png 2x"/></a></span></td><tdclass="mbox-text">This page is within the scope of the <b><arel="mw:WikiLink"href="./Wikipedia:Help_Project"title="Wikipedia:Help Project">Wikipedia Help Project</a></b>, a collaborative effort to improve Wikipedia's help documentation for readers and contributors. If you would like to participate, please visit <arel="mw:WikiLink"href="./Wikipedia:Help_Project"title="Wikipedia:Help Project">the project page</a>, where you can join the <arel="mw:WikiLink"href="./Wikipedia_talk:Help_Project"title="Wikipedia talk:Help Project">discussion</a> and see a list of open tasks. To browse help related resources see the <arel="mw:WikiLink"href="./Help:Menu"title="Help:Menu">Help Menu</a> or <arel="mw:WikiLink"href="./Help:Contents"title="Help:Contents">Help Directory</a>. Or <spanclass="noprint plainlinks"title="Edit Special:MyTalk"><arel="mw:ExtLink"href="//en.wikipedia.org/w/index.php?title=Special:MyTalk&action=edit&section=new&preload=Help:Contents/helpmepreload&preloadtitle=Help+me%21"class="external text"><b>ask for help on your talk page</b></a></span> and a volunteer will visit you there.<spanclass="metadata"style="display:none; speak:none;"><spanclass="wpb-project">Help</span><spanclass="wpb-project_link">Wikipedia:Help Project</span><spanclass="wpb-banner_name">Template:Wikipedia Help Project</span><spanclass="wpb-assessment_cat">Help articles</span></span></td><tdclass="mbox-empty-cell"></td></tr><tr>
<tdclass="mbox-text"colspan="2">This page does not require a rating on the project's <arel="mw:WikiLink"href="./Wikipedia:Help_Project/Assessment#Quality_scale"title="Wikipedia:Help Project/Assessment">quality scale</a>.</td>
</tr><tr>
<tdclass="import import-high "style="
text-align:center;
white-space:nowrap;
font-weight:bold;
background:
#ffacff;
"about="#mwt15"typeof="mw:ExpandedAttrs"data-mw='{"attribs":[[{"txt":"style"},{"html":"\n text-align:center;\n white-space:nowrap;\n font-weight:bold;\n background:<span typeof=\"mw:Nowiki\" data-parsoid=\"{}\">\n#ffacff</span>;\n "}]]}'><spantypeof="mw:Entity"></span><arel="mw:WikiLink"href="./Category:High-importance_Help_articles"title="Category:High-importance Help articles">High</a><spantypeof="mw:Entity"></span></td>
<tdclass="mbox-text"colspan="2">This page has been rated as <b>High-importance</b> on the project's <arel="mw:WikiLink"href="./Wikipedia:Help_Project/Assessment#Importance_scale"title="Wikipedia:Help Project/Assessment">importance scale</a>.</td>
<pid="mwCA">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 <arel="mw:WikiLink"href="./Wikipedia:TemplateData/Tutorial"title="Wikipedia:TemplateData/Tutorial"id="mwCQ">Wikipedia:TemplateData/Tutorial</a> in the lead section. --<arel="mw:WikiLink"href="./User:BoldLuis"title="User:BoldLuis"id="mwCg">BoldLuis</a> (<arel="mw:WikiLink"href="./User_talk:BoldLuis"title="User talk:BoldLuis"id="mwCw">talk</a>) 10:09, 3 May 2020 (UTC)</p>
</section><sectiondata-mw-section-id="2"id="mwDA"><h2id="documentation_automatically_included_in_all_templates">documentation automatically included in all templates</h2>
<pid="mwDQ"><spantypeof="mw:Transclusion mw:Entity"about="#mwt18"data-mw='{"parts":[{"template":{"target":{"wt":"tl","href":"./Template:Tl"},"params":{"1":{"wt":"documentation"}},"i":0}}]}'id="mwDg">{</span><spantypeof="mw:Entity"about="#mwt18">{</span><arel="mw:WikiLink"href="./Template:Documentation"title="Template:Documentation"about="#mwt18">documentation</a><spantypeof="mw:Entity"about="#mwt18">}</span><spantypeof="mw:Entity"about="#mwt18">}</span> would be included by default in all the templates, excepting when <spantypeof="mw:Transclusion mw:Entity"about="#mwt19"data-mw='{"parts":[{"template":{"target":{"wt":"tl","href":"./Template:Tl"},"params":{"1":{"wt":"noincdoc"}},"i":0}}]}'id="mwDw">{</span><spantypeof="mw:Entity"about="#mwt19">{</span><arel="mw:WikiLink"href="./Template:Noincdoc"title="Template:Noincdoc"about="#mwt19"class="new">noincdoc</a><spantypeof="mw:Entity"about="#mwt19">}</span><spantypeof="mw:Entity"about="#mwt19">}</span> (or similar code) is used (I think there is no reason to exclude documentation in templates anyway).</p>
<pid="mwEA">The same for the TemplateData content, including its template detected parameters, when the documentation page is automatically created (just after template creation). --<arel="mw:WikiLink"href="./User:BoldLuis"title="User:BoldLuis"id="mwEQ">BoldLuis</a> (<arel="mw:WikiLink"href="./User_talk:BoldLuis"title="User talk:BoldLuis"id="mwEg">talk</a>) 11:08, 3 May 2020 (UTC)</p>
</section><sectiondata-mw-section-id="3"id="mwEw"><h2id="Notice_of_new_template_{{Param_value}}_for_assistance_in_template_doc_pages"><spanid="Notice_of_new_template_.7B.7BParam_value.7D.7D_for_assistance_in_template_doc_pages"typeof="mw:FallbackId"></span>Notice of new template <spantypeof="mw:Transclusion mw:Entity"about="#mwt20"data-mw='{"parts":[{"template":{"target":{"wt":"tl","href":"./Template:Tl"},"params":{"1":{"wt":"Param value"}},"i":0}}]}'id="mwFA">{</span><spantypeof="mw:Entity"about="#mwt20">{</span><arel="mw:WikiLink"href="./Template:Param_value"title="Template:Param value"about="#mwt20">Param value</a><spantypeof="mw:Entity"about="#mwt20">}</span><spantypeof="mw:Entity"about="#mwt20">}</span> for assistance in template doc pages</h2>
<pid="mwFQ">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 <spantypeof="mw:Entity"id="mwFg"><</span>code> tag, which I had been using previously. The use case was the documentation for <spantypeof="mw:Transclusion mw:Entity"about="#mwt21"data-mw='{"parts":[{"template":{"target":{"wt":"tl","href":"./Template:Tl"},"params":{"1":{"wt":"Lorem ipsum"}},"i":0}}]}'id="mwFw">{</span><spantypeof="mw:Entity"about="#mwt21">{</span><arel="mw:WikiLink"href="./Template:Lorem_ipsum"title="Template:Lorem ipsum"about="#mwt21">Lorem ipsum</a><spantypeof="mw:Entity"about="#mwt21">}</span><spantypeof="mw:Entity"about="#mwt21">}</span>, 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: <codestyle="border:thin solid #caa;background-color:white;padding:1px 2px 0 1px;margin:0 2px 0 1px;white-space:nowrap;"about="#mwt22"typeof="mw:Transclusion"data-mw='{"parts":[{"template":{"target":{"wt":"param value","href":"./Template:Param_value"},"params":{"1":{"wt":" * \" "}},"i":0}}]}'id="mwGA"><spantypeof="mw:Entity"></span><spantypeof="mw:Entity">*</span><spantypeof="mw:Entity"></span>"<spantypeof="mw:Entity"></span></code>. The new template <spantypeof="mw:Transclusion mw:Entity"about="#mwt23"data-mw='{"parts":[{"template":{"target":{"wt":"tl","href":"./Template:Tl"},"params":{"1":{"wt":"param value"}},"i":0}}]}'id="mwGQ">{</span><spantypeof="mw:Entity"about="#mwt23">{</span><arel="mw:WikiLink"href="./Template:Param_value"title="Template:Param value"about="#mwt23">param value</a><spantypeof="mw:Entity"about="#mwt23">}</span><spantypeof="mw:Entity"about="#mwt23">}</span> was my attempted solution for this problem. You can see some examples of it in use at <arel="mw:WikiLink"href="./Template:Lorem_ipsum#Prefix_and_suffix_whitespace"title="Template:Lorem ipsum"id="mwGg">Template:Lorem ipsum#Prefix and suffix whitespace</a>. <arel="mw:WikiLink"href="./User:Mathglot"title="User:Mathglot"id="mwGw">Mathglot</a> (<arel="mw:WikiLink"href="./User_talk:Mathglot"title="User talk:Mathglot"id="mwHA">talk</a>) 10:32, 8 August 2021 (UTC)</p>
<pid="mwHg">This page doesn't say where or how to put the TemplateData, even though <arel="mw:WikiLink"href="./Template:Infobox_person#TemplateData"title="Template:Infobox person"id="mwHw">many</a><arel="mw:WikiLink"href="./Template:Cite_web#TemplateData"title="Template:Cite web"id="mwIA">many</a> templates use a standard format (seen below). I suggest this page include it in the <arel="mw:WikiLink"href="./Wikipedia:Template_documentation#Manual_creation"title="Wikipedia:Template documentation"id="mwIQ">#Manual creation</a> section, and in the prefilled creation link provided by <spantypeof="mw:Transclusion mw:Entity"about="#mwt24"data-mw='{"parts":[{"template":{"target":{"wt":"tl","href":"./Template:Tl"},"params":{"1":{"wt":"documentation"}},"i":0}}]}'id="mwIg">{</span><spantypeof="mw:Entity"about="#mwt24">{</span><arel="mw:WikiLink"href="./Template:Documentation"title="Template:Documentation"about="#mwt24">documentation</a><spantypeof="mw:Entity"about="#mwt24">}</span><spantypeof="mw:Entity"about="#mwt24">}</span>, and putting it at the very bottom of the documentation subpage. There was also a <arel="mw:WikiLink"href="./Template_talk:Documentation/Archive_8#Integrating_TemplateData"title="Template talk:Documentation/Archive 8"id="mwIw">discussion</a> 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?</p>