Mailinglist Archive: opensuse-wiki (149 mails)
| < Previous | Next > |
[opensuse-wiki] wiki.o.o news 02/15
- From: Henne Vogelsang <hvogel@xxxxxxxxxxxx>
- Date: Mon, 15 Feb 2010 17:35:01 +0100
- Message-id: <4B7977B5.4050702@xxxxxxxxxxxx>
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@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-wiki+help@xxxxxxxxxxxx
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@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-wiki+help@xxxxxxxxxxxx
| < Previous | Next > |