Hi, I've spent some time working on documenting the templates in wiki.o.o as suggested in [1], so here is small report and some random thoughts: 1. Every template (except a few - more on this below) in wiki.o.o instance now has its /doc subpage with information about how to use the template (code), general description, where to use it/not to use it and in some cases there is also list of related templates. The documentation could definitely not perfect, but IMHO it is a good start to having general policy that every template should be documented. 2. It seems nobody has objections against making it policy that every $template has to be documented in $template/doc, so I'll mention it in [2] (this is yet to be done if nobody raises objections). 3. The exceptions for which I did not make /doc subpage, as mentioned in point 1, are: Template:App \ Template:Appg | Template:Appk +-> I don't understand what are these good for Template:Appj / Template:Meeting - marked as 'template to rethink', looks useless to me Template:Infobox software, Template:Information: these two templates look very similar, I don't get the difference. Are both really needed? 4. TOCRight template: do we really need this? In en.o.o, only a few pages use this template and IMHO it doesn't look very nice. 5. The templates related to portals were taken from wikipedia, where these templates are also perfectly documented. IMO it would be useless to copy their documentation to wiki.o.o, so I've basically just linked the documentation to our wiki. 6. There are several navigation bar templates in the wiki. I think these templates might be placed into something like [[Category:NavBars]], so it would be easier to find proper Navbar when creating new article. Wikipedia uses something similar. What do you think? 7. I've fixed capitalization of categories, so all the categories now follow the naming conventions. 8. ATM, the documentation of a template is displayed below the template content, which is fine for small templates like AI [3], but isn't so fine for bigger templates like Article boilerplate [4]. If the user opens [4], the documentation should be better visible. I see two options, none of them ideal: a) put the documentation above the template content b) make the template content <includeonly>, so only the documentation would be visible, but then it couldn't be used as an example of recommended article layout. Any ideas? 9. Template:{Torrent, Video} These two templates were implemented using titled-click-external template, which a) isn't in wiki.o.o b) is deprecated according to Wikipedia So I've reworked Video and Torrent templates using [[image:Video.png|22px|link={{{1}}}]] syntax. It should work the same way as before except that it now adds another icon representing external link [5]. I don't know how to get rid of this icon (does it mind actually??), so if ((this is not desired && can not be fixed) || (there are some other drawbacks I didn't notice)), then please revert these two templates back. [1] http://lists.opensuse.org/opensuse-wiki/2010-02/msg00055.html [2] http://wiki.opensuse.org/Help:Template [3] http://wiki.opensuse.org/Template:AI [4] http://wiki.opensuse.org/Template:Article [5] http://wiki.opensuse.org/User:Puzel/Test Petr -- Petr Uzel, openSUSE Boosters Team IRC: ptr_uzl @ freenode