[opensuse-wiki] wiki.o.o news 02/15
Hi, After i moved everything from the openSUSE namespace into the Help namespace which was very straightforward i started to wade through the Template namespace. I must say i get frustrated with the cruft that is already in this instance by today. There were a lot of "standard" Templates that did not follow our own Template guidelines. CamelCase naming, strange content and most of them had no documentation at all. I fixed all the case and content issues and with documentation i got as far as the letter B. I used the wikipedia way of documenting templates. Every template has a subpage /doc which provides the documentation. You include it on the Template page in a 'noinclude' block so it does not get included when you include the Template. It's easier as it sounds ;) Just look at the first Template we have: AI http://wiki.opensuse.org/Template:AI This way explaining a Template on a some page is as easy as {{AI|000001}} {{AI/doc}} So if you want to help you can go through the Templates[1] and create documentation where its missing. Thats it for today. Henne [1] http://bit.ly/bilRR5 -- Henne Vogelsang, openSUSE. Everybody has a plan, until they get hit. - Mike Tyson -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-wiki+help@opensuse.org
On Monday 15 February 2010 10:35:01 Henne Vogelsang wrote:
I must say i get frustrated with the cruft that is already in this instance by today.
The App* are bad example of template usage.
strange content and most of them had no documentation at all
Some templates are wikipedia workarounds, some are just wrong/suspicious benefits in application of templates, I'll go trough en.o.o tonight and try to clean up this. Also I'll add template docs writing as one of tasks to transition instructions on en.o.o. -- Regards Rajko, -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-wiki+help@opensuse.org
Henne,
thanks for these daily reports. As of the template mess: Remy and
Rajko already did a clean-up here actually for the reviewing process
and came up with
http://en.opensuse.org/openSUSE:Wiki_Tag_Guidelines and
http://en.opensuse.org/openSUSE:Wiki_Template_Guidelines
as a listing of templates actually useful and thus preserved from the
mess of thousands. I'm a bit curious why we do this again now. Lack of
communication? Or do I get something completely wrong here?
Rajko? Remy?
Best,
R
2010/2/15 Henne Vogelsang
Hi,
After i moved everything from the openSUSE namespace into the Help namespace which was very straightforward i started to wade through the Template namespace. I must say i get frustrated with the cruft that is already in this instance by today. There were a lot of "standard" Templates that did not follow our own Template guidelines. CamelCase naming, strange content and most of them had no documentation at all. I fixed all the case and content issues and with documentation i got as far as the letter B. I used the wikipedia way of documenting templates.
Every template has a subpage /doc which provides the documentation. You include it on the Template page in a 'noinclude' block so it does not get included when you include the Template. It's easier as it sounds ;) Just look at the first Template we have: AI
http://wiki.opensuse.org/Template:AI
This way explaining a Template on a some page is as easy as
{{AI|000001}} {{AI/doc}}
So if you want to help you can go through the Templates[1] and create documentation where its missing. Thats it for today.
Henne
[1] http://bit.ly/bilRR5 -- Henne Vogelsang, openSUSE. Everybody has a plan, until they get hit. - Mike Tyson -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-wiki+help@opensuse.org
-- Rupert Horstkötter, open-slx gmbh openSUSE Board Member openSUSE Community Assistant http://en.opensuse.org/User:Rhorstkoetter Email: rhorstkoetter@opensuse.org Jabber: ruperthorstkoetter@googlemail.com -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-wiki+help@opensuse.org
Hi, On 16.02.2010 18:33, Rupert Horstkötter wrote:
thanks for these daily reports. As of the template mess: Remy and Rajko already did a clean-up here actually for the reviewing process and came up with
http://en.opensuse.org/openSUSE:Wiki_Tag_Guidelines and http://en.opensuse.org/openSUSE:Wiki_Template_Guidelines
Which are now http://wiki.opensuse.org/Help:Template http://wiki.opensuse.org/Help:Tag The problem is that a lot of the Templates don't follow these rules strictly and if we need people to a) follow the guidelines and b) pick up maintenance tasks they need strict, easy to understand, easy to follow rules. We (Rajko, Remy and me) talked about this in the wiki channel btw ;) Henne -- Henne Vogelsang, openSUSE. Everybody has a plan, until they get hit. - Mike Tyson -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-wiki+help@opensuse.org
2010/2/17 Henne Vogelsang
Hi,
On 16.02.2010 18:33, Rupert Horstkötter wrote:
thanks for these daily reports. As of the template mess: Remy and Rajko already did a clean-up here actually for the reviewing process and came up with
http://en.opensuse.org/openSUSE:Wiki_Tag_Guidelines and http://en.opensuse.org/openSUSE:Wiki_Template_Guidelines
Which are now
http://wiki.opensuse.org/Help:Template http://wiki.opensuse.org/Help:Tag
The problem is that a lot of the Templates don't follow these rules strictly and if we need people to a) follow the guidelines and b) pick up maintenance tasks they need strict, easy to understand, easy to follow rules. We (Rajko, Remy and me) talked about this in the wiki channel btw ;)
Yes, we cleaned the templates before drafting the guidelines... and never adapted the Templates to them :] Btw, good job Henne :] R. -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-wiki+help@opensuse.org
2010/2/17 Rémy Marquis
2010/2/17 Henne Vogelsang
: Hi,
On 16.02.2010 18:33, Rupert Horstkötter wrote:
thanks for these daily reports. As of the template mess: Remy and Rajko already did a clean-up here actually for the reviewing process and came up with
http://en.opensuse.org/openSUSE:Wiki_Tag_Guidelines and http://en.opensuse.org/openSUSE:Wiki_Template_Guidelines
Which are now
http://wiki.opensuse.org/Help:Template http://wiki.opensuse.org/Help:Tag
The problem is that a lot of the Templates don't follow these rules strictly and if we need people to a) follow the guidelines and b) pick up maintenance tasks they need strict, easy to understand, easy to follow rules. We (Rajko, Remy and me) talked about this in the wiki channel btw ;)
OK, thanks for clarifying this.
Yes, we cleaned the templates before drafting the guidelines... and never adapted the Templates to them :] Btw, good job Henne :]
+1, thanks a lot! Best, R
R.
-- Rupert Horstkötter, open-slx gmbh openSUSE Board Member openSUSE Community Assistant http://en.opensuse.org/User:Rhorstkoetter Email: rhorstkoetter@opensuse.org Jabber: ruperthorstkoetter@googlemail.com -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-wiki+help@opensuse.org
On Monday 15 February 2010 10:35:01 Henne Vogelsang wrote:
Hi,
... So if you want to help you can go through the Templates[1] and create documentation where its missing. Thats it for today.
I just found source of confusion: http://wiki.opensuse.org/Help:Template it obviously needs update. For now I removed whole section Multimedia as all templates there were based on Titled click. Tomorrow I'll look further in Help:Template and template name space. I will probably break article in 2 parts, 1 list of often used templates, and 2 explanation how to use them, how to create them, how to choose title and so on. The creation of templates has a lot common with creation of any article and that must be considered, so that we don't contradict. Probably one article as subpage to style guide that will be transcluded in both will be the best option. I went trough http://wiki.opensuse.org/index.php?title=Special:AllPages&from=AI&namespace=10 and removed templates "Titled click", "Titled-click external" and all that use them. With new format of File: (Image:) there is no need for tittled click and any other template that is using it. You can link any image to any file and that is whole purpose of both Titled clicks. This page explains what is possible with File tag: http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files It uses both Image and File names in examples, so we can consider that equivalent; at least until Wikipedia tells different. Above episode with templates probably explains more then any word why we wanted to move to new instance without further fixing files on existing, en.o.o, wiki. The procedure would be just as you started, by creating some infrastructure, then moving basics like Download, Installation etc, then fixing infrastructure details that were forgotten, then adding more until majority is transferred. In that context pages in User namespace are user problem. Each should be able to transfer them after notification that switch of wiki.o.o and en.o.o is following. I see that you made template for user page, but IMHO, required format is applicable for people that must have contact information, like Ambassadors, team leads, and for all other it is user preference to have standardized info, some other layout, some other information, or nothing at all, but that is topic for Help:User pages ^^ -- Regards Rajko, -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-wiki+help@opensuse.org
Rajko, Henne,
I tried to get feedback regarding the templates yesterday already but
haven't got a response (so far). Actually I'm currently very confused
what you argue about the template mess as to my knowledge we already
did an extensive re-organization of these in old wiki (for the
reviewing process) and came up with these useful and to be preserved
templates:
http://en.opensuse.org/openSUSE:Wiki_Tag_Guidelines and
http://en.opensuse.org/openSUSE:Wiki_Template_Guidelines
Afaik, Remy and Rajko were in charge here. May you please comment on
this one? Either we re-invent the (already invented) wheel here
currently or I got something completely wrong.
Thanks for your efforts!
Best,
R
2010/2/17 Rajko M.
On Monday 15 February 2010 10:35:01 Henne Vogelsang wrote:
Hi,
... So if you want to help you can go through the Templates[1] and create documentation where its missing. Thats it for today.
I just found source of confusion: http://wiki.opensuse.org/Help:Template it obviously needs update.
For now I removed whole section Multimedia as all templates there were based on Titled click. Tomorrow I'll look further in Help:Template and template name space. I will probably break article in 2 parts, 1 list of often used templates, and 2 explanation how to use them, how to create them, how to choose title and so on. The creation of templates has a lot common with creation of any article and that must be considered, so that we don't contradict. Probably one article as subpage to style guide that will be transcluded in both will be the best option.
I went trough http://wiki.opensuse.org/index.php?title=Special:AllPages&from=AI&namespace=10 and removed templates "Titled click", "Titled-click external" and all that use them.
With new format of File: (Image:) there is no need for tittled click and any other template that is using it. You can link any image to any file and that is whole purpose of both Titled clicks.
This page explains what is possible with File tag: http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files It uses both Image and File names in examples, so we can consider that equivalent; at least until Wikipedia tells different.
Above episode with templates probably explains more then any word why we wanted to move to new instance without further fixing files on existing, en.o.o, wiki.
The procedure would be just as you started, by creating some infrastructure, then moving basics like Download, Installation etc, then fixing infrastructure details that were forgotten, then adding more until majority is transferred.
In that context pages in User namespace are user problem. Each should be able to transfer them after notification that switch of wiki.o.o and en.o.o is following.
I see that you made template for user page, but IMHO, required format is applicable for people that must have contact information, like Ambassadors, team leads, and for all other it is user preference to have standardized info, some other layout, some other information, or nothing at all, but that is topic for Help:User pages ^^
-- Regards Rajko, -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-wiki+help@opensuse.org
-- Rupert Horstkötter, open-slx gmbh openSUSE Board Member openSUSE Community Assistant http://en.opensuse.org/User:Rhorstkoetter Email: rhorstkoetter@opensuse.org Jabber: ruperthorstkoetter@googlemail.com -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-wiki+help@opensuse.org
Hello, (Henne, you work on the wiki on Rosenmontag? *looking confused*) on Montag, 15. Februar 2010, Henne Vogelsang wrote:
I used the wikipedia way of documenting templates.
Every template has a subpage /doc which provides the documentation. You include it on the Template page in a 'noinclude' block so it does not get included when you include the Template. It's easier as it sounds ;)
I like the basic idea, but I'd like to propose to follow the wikipedia way a bit more ;-) Currently you use <noinclude> {{{{PAGENAME}}/doc}} </noinclude> which of course works. I'd propose to follow the wikipedia way a bit more - they use <noinclude> {{documentation}} </noinclude> This needs the additional Template:Documentation, but has the advantage that it automatically shows a hint where the documentation is placed, an edit link for the templace documentation, adds a frame to the documentation etc. For an example, see http://en.wikipedia.org/wiki/Template:Documentation Regards, Christian Boltz -- Ich soll keine fünfzeiligen Sigs schreiben. Ich soll keine fünfzeiligen Sigs schreiben. Ich soll keine fünfzeiligen Sigs schreiben. Ich soll keine fünfzeiligen Sigs schreiben. Ich soll keine fünf... -- To unsubscribe, e-mail: opensuse-wiki+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-wiki+help@opensuse.org
participants (5)
-
Christian Boltz
-
Henne Vogelsang
-
Rajko M.
-
Rupert Horstkötter
-
Rémy Marquis