Topic on Template talk:Note/Archive 2

Currently, the template's documentation is split across the template page and a documentation subpage like so:

{{documentation|content=
<translate>
== Usage == <!--T:3-->
</translate>
<pre>
{{Note|Foo}}
{{Note|Foo|info}}
{{Note|Foo|reminder}}
{{Note|Foo|warn}}
{{Note|Foo|error}}
{{Note}} <translate nowrap><!--T:6--> Loose test</translate>

* Text {{Note|Foo|inline=1}}
</pre>
{{Note|Foo}}
{{Note|Foo|info}}
{{Note|Foo|reminder}}
{{Note|Foo|warn}}
{{Note|Foo|error}}
{{Note}} <translate><!--T:4--> Loose test</translate>

* Text {{Note|Foo|inline=1}}

== Parameters ==

{{Note/doc}}

}}
[[Category:Templates{{#translation:}}|{{PAGENAME}}]]

Please move the Usage content to the documentation subpage along with the other documentation, and replace everything quoted here with a simple {{Documentation}} transclusion. This will mean that the documentation box displays the standard view/edit/history links to the subpage, and will make the existence of Template:Note/doc discoverable without having to read the template source.

(Actually, I've Been Bold and already added the |content= documentation to Template:Note/doc, temporarily surrounded by tags to prevent duplicate information from being displayed. So, all that needs to be done is to update the template source, and remove the <noinclude> tags on the documentation page.)

Template's documentation pages (/doc) should not have ‎<translate>...‎</translate> tags for consistency with other templates.

Oh! Really? My mistake, I'll fix that up.

@Shirayuki: Or perhaps I misunderstood — are you saying that the template documentation shouldn't be placed on the Template:Note/doc subpage, because it needs to be translated on the main template page instead?

I took your response to mean that the <translate> tags should be removed, when moving it to the doc page... but now I'm questioning whether I've got that right.

By making Template:Note/doc translatable and translating it, Template:Note/doc/ja will be created. This differs from the existing Template:SettingSummary/ja/doc naming.