Kay, 2010/1/7 Kay Schenk <kay.schenk@gmail.com>:
On 01/07/2010 02:04 AM, Rupert Horstkötter wrote:
2010/1/6 Kay Schenk <kay.schenk@gmail.com>:
ditto for me! Instructions WAY too confusing and off-putting! yikes! Although I understand that cleanup is needed, maybe everything should be transitioned to new setup (somehow--I can't even get my head around the namespace business and how it applies to existing pages if you want to know the truth! :/) and then go back to template compliance. Or, put up a "generic template" and tell us how to paste germaine content into it?
After re-reading http://en.opensuse.org/Transition_Guidelines#Step_1_:_Articles_review I honestly don't know how we should explain the process even more straightforward.
Rupert--
The explanation of the process IS straightforward...it's the process itself and the intricacies with it that are confusing for folks who are not versed in the internals of the wiki.
For example, the last instruction on "Choosing an article" says this...
* Then go to the current article and put the Template:InReview at the top of its page, along with with {{InReview|YourWikiName}}
*Confused* You put {{InReview|YourWikiName}} on top of the article source-code, that's it.
hmmmm....???? a link on how to do this or what you mean by this would be VERY helpful.
Under "Format Check" is a very long list of regulations. My initial reaction to this is one of great confusion. I don't really understand the need to as many references as you have here. For example:
# Follows the openSUSE:Article Template # Uses standardized Templates only. See openSUSE:Wiki_Template_Guidelines for the main templates to be used.
so how many templates should I follow, and how do I actually use/insert them?
Every article should match the Article Template. The Template Guidelines explain the use of standardized wiki templates where appropriate (like e.g. a Version note or similar). The usage of these is explained (with Code sample) at http://en.opensuse.org/openSUSE:Wiki_Template_Guidelines and http://en.opensuse.org/openSUSE:Wiki_Tag_Guidelines
I think a nice little short instruction page on the use of templates would be great! I see you have a link to the wikipedia Help:Template page but, well, this isn't very easy to decipher really.
My ONE big suggestion at the moment would be to considerably simplify the "Format check" section in some way if you can.
Sorry, I see where you're coming from but I honestly don't see an opportunity to further simplify the process as it actually involves the steps outlined at Format Check.
Next would be to do up a very short page from this one -- http://en.opensuse.org/openSUSE:Wiki_Template_Guidelines#Standardized_templa...
----> this little section When creating a new article or portal, make sure to use
* Article template * Portal Template
linking the word "use" into a short tutorial on how to "use" the openSuSE standardized templates ...
May you please, as Uwe suggested, use a already "reviewed" and/or "in review" page? This is the best example you may get here. Does this address your questions/concerns? I am (we're) certainly open for suggestion on HOW to simplify the Format Check though. Best, R
We're certainly open for suggestions though. As of
http://en.opensuse.org/openSUSE:Article_Template .. It's a general template we value to ensure a consistent look&feel when browsing the wiki. What specific information is needed and valid for a specific article is certainly the estimation of the reviewer (also what information is not).
Looking forward to your suggestions and thanks for participating, R
-- ============================================================ Kay Schenk ph: 530-898-5339 Applications Development and Enterprise Design CSU, Chico
"No one ever regarded the First of January with indifference. It is that from which all date their time, and count upon what is left. It is the nativity of our common Adam." -- Charles Lamb -- 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