Template talk:Newtemplate: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Robert W King
No edit summary
imported>David Yamakuchi
Line 10: Line 10:
:I think this should be on every template (except for subpage article templates, of course), in order to document its usage and instructions.  Hopefully this will provide a great level of "ease of use" for all templates (and even encourage development and refinement of existing ones).
:I think this should be on every template (except for subpage article templates, of course), in order to document its usage and instructions.  Hopefully this will provide a great level of "ease of use" for all templates (and even encourage development and refinement of existing ones).
:The different sections are intended as documentation; like a "developer notes" or "instructions".  Obviously there might be some times when a better or different template should be used, or in cases where you really can't use a template with existing templates.  And if something goes wrong with the template, you should know who to go to to have it fixed.  --[[User:Robert W King|Robert W King]] 11:32, 13 January 2008 (CST)
:The different sections are intended as documentation; like a "developer notes" or "instructions".  Obviously there might be some times when a better or different template should be used, or in cases where you really can't use a template with existing templates.  And if something goes wrong with the template, you should know who to go to to have it fixed.  --[[User:Robert W King|Robert W King]] 11:32, 13 January 2008 (CST)
== Newtemplate and pre-expand sizes ==
I just saw a number of cases where the {{tl|Newtemplate}} caused a substantial increase in size in the resulting new templates footprint.  Using an "example" seemed like it made it particularly bad.  Since anything "in" the template page needs to be accessed for every call of the template, shouldn't we put all the documentation stuff on the talk page as a practice?--[[User:David Yamakuchi|David Yamakuchi]] 02:15, 11 April 2008 (CDT)

Revision as of 02:15, 11 April 2008

Hey Robert,

Questions:

  • Is this always required (on your view)?
  • If not always, then when?
  • What are the rationales for the different sections?

--Larry

I think this should be on every template (except for subpage article templates, of course), in order to document its usage and instructions. Hopefully this will provide a great level of "ease of use" for all templates (and even encourage development and refinement of existing ones).
The different sections are intended as documentation; like a "developer notes" or "instructions". Obviously there might be some times when a better or different template should be used, or in cases where you really can't use a template with existing templates. And if something goes wrong with the template, you should know who to go to to have it fixed. --Robert W King 11:32, 13 January 2008 (CST)

Newtemplate and pre-expand sizes

I just saw a number of cases where the {{Newtemplate}} caused a substantial increase in size in the resulting new templates footprint. Using an "example" seemed like it made it particularly bad. Since anything "in" the template page needs to be accessed for every call of the template, shouldn't we put all the documentation stuff on the talk page as a practice?--David Yamakuchi 02:15, 11 April 2008 (CDT)