Template talk:Newtemplate

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)

It shouldn't be a problem. Look at sodium. There the current numbers are:

• Pre-expand include size: 73527 bytes
• Post-expand include size: 121808 bytes
• Template argument size: 4156 bytes

I'll revert back and check to see what they are without the newtemplate on the template. Hold on. Chris Day 02:19, 11 April 2008 (CDT)

The numbers now, on Sodium, without the newtemplate content at the front are:

• Pre-expand include size: 70974 bytes
• Post-expand include size: 121808 bytes
• Template argument size: 4156 bytes

The only difference is less than 3,000 bytes. A frequently used template might be a problem but the {{Periodic}} and {{Elem Infobox}} are only called once each per element page. Chris Day 02:24, 11 April 2008 (CDT)

See, it does matter...a little. I'm not saying it's a problem, I'm just saying that is info for authors only and doesn't need to be loaded with every page view, right?...--David Yamakuchi 02:27, 11 April 2008 (CDT)

I thought the idea was to slap this thing on every template, period. That seems to me to be an awful lot of loading author, caveats, etc to "end users" that won't even know that they are looking at a template. IDK, seems like Talk is the place for that...no?--David Yamakuchi 02:30, 11 April 2008 (CDT)