Templates Wiki

Editing

Forum:Dual template documentation

1
  • The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit. If you are undoing an edit that is …
Latest revision Your text
Line 25: Line 25:
   
 
== The procedure ==
 
== The procedure ==
I think that if we go forward, the procedure ought to be fourfold...
+
I think that if we go forward, the procedure ought to be threefold...
 
=== 1. Remove Template:SPW from play ===
 
=== 1. Remove Template:SPW from play ===
 
Currently there is a template at [[:Template:SPW]] that tells users of this wiki if a page is on Starter Pages Wiki. Nobody is going to copy that template to their wiki, or at least, they shouldn't, because it doesn't convey information useful to wikis besides this one. Yet we call that template in our documentation pages, forcing a gross redlink on other wikis.
 
Currently there is a template at [[:Template:SPW]] that tells users of this wiki if a page is on Starter Pages Wiki. Nobody is going to copy that template to their wiki, or at least, they shouldn't, because it doesn't convey information useful to wikis besides this one. Yet we call that template in our documentation pages, forcing a gross redlink on other wikis.
Line 36: Line 36:
 
=== 3. Isolate install instructions and move to a new /install subpage; transclude with [[:Template:Documentation]] ===
 
=== 3. Isolate install instructions and move to a new /install subpage; transclude with [[:Template:Documentation]] ===
 
There will be instructions to install many templates. And that is fine. But a user is not interested in including these instructions on their wiki. So, isolate them, and move them to an /install subpage next to the /doc subpage. Display both with our [[:Template:Documentation]] - when copied, others' Documentation templates will only display the /doc. [[User:Henstepl|Henstepl]] ([[User talk:Henstepl|talk]]) 03:39, August 22, 2017 (UTC)
 
There will be instructions to install many templates. And that is fine. But a user is not interested in including these instructions on their wiki. So, isolate them, and move them to an /install subpage next to the /doc subpage. Display both with our [[:Template:Documentation]] - when copied, others' Documentation templates will only display the /doc. [[User:Henstepl|Henstepl]] ([[User talk:Henstepl|talk]]) 03:39, August 22, 2017 (UTC)
 
Interlanguage links can be placed on the /install page and transcluded onto the template page - and then, they also will not be copied to new wikis. It is unfortunate that for our goals to be met, we would have to remove interlanguage links from /doc subpages... But really, now, are ''subpage'' interwikis necessary?
 
 
=== 4. Categories ===
 
There used to be more categories for templates on [[w:c:starter]], but now there is only exactly one: [[w:c:starter:Category:Templates]]. All the others template categories in use on this wiki are liable to generate ugly redlinks... Should we really assume that there will be a "Category:General wiki templates" on a wiki? Should there ''be'' such a category?
 
 
This part of the proposal may be controversial but I would think it to be necessary for the purpose. I propose that categories other than Category:Templates be removed from templates, or at least moved to the /install subpage from which they will not be copied as the template is copied. There may be some exceptions: [[:Category:Emoticons]], for example, is unlikely to have only one or two of its members copied away, but more likely very many, so it should include the category "Emoticons" and instructions to create that category in the /install page.
 
  Loading editor