Mailinglist Archive: opensuse-wiki (174 mails)

< Previous Next >
Re: [opensuse-wiki] AI2, AI 5 & AI6 Status report
  • From: Rémy Marquis <remy.marquis@xxxxxxxxx>
  • Date: Wed, 16 Dec 2009 00:00:46 +1100
  • Message-id: <5472c28e0912150500s7130d329y2df445a9f5941567@xxxxxxxxxxxxxx>

Some feedback/suggestions:

1. Do we need "general help" in the knowledge bar? I.e. what should be
linked there in particular? Wouldn't it be better to leave this apart
and put "related articles" there (currently on the very bottom)?
That'd be even more useful unless someone explains the actual need of
"general help".

I agree. Originally, I put direct links to general help here because I
didn't know what to put to "fil the gap" :)
Let's move the "See also" section here instead (shall we rename it
"Related articles" ?)

2. Not sure how difficult that'd be but I'd appreciate to have a
second article-template with a vertical right-aligned table of
contents instead of the horizontal one we currently have. I assume
this is a matter of minutes for wiki seniors :-) Is it? Not sure, but
I THINK this may look even better. May you come up with a second one
to compare please?

Well, I got mixed feeling about the results I obtained.

Looking at the pages that actually use TOCright (
http://en.opensuse.org/Special:WhatLinksHere/Template:TOCright ) and
playing with the page I newly created (
http://en.opensuse.org/openSUSE:Article_Template2 ), we can observe
lot of inconsistency depending on the content of the page.
Sometime the TOC integrate well into the page, sometimes it pulls down
all the text leaving a large blank space (specially when we use a wide
Template such as Info or Warning).. I think it's also not easy to
correct it everywhere, because even though we can modify all
templates, the effects of the TOC depend on the length of the TOC
(length of article) and the length of the headings and section title.

For the moment, I would go using the horizontal TOC to give a more
consistent, professional aspect to the wiki.


AI#5 : Wiki Guidelines
---------------------------
I've cleaned, merged the bunch of articles that were talking about
Guidelines.
The new "Wiki Guidelines" can be accessed here :
http://en.opensuse.org/openSUSE:Wiki_Guidelines

That's a good start. That said, we absolutely cannot put this (...)
online and publicly available. This has to be formulated way more
diplomatic :-)

"Put online in August 2005, the openSUSE wiki has proved to be an
invaluable documentation resource for users as well as contributors
and developers. However, the number of page exponentially increased
over the years and this uncontrolled growth came at the expense of the
overall quality of the openSUSE wiki, with articles only partially
written or duplicating others."

Hopefully, you don't know what was my initial thought when I wrote
this sentence ;)
Any help to give more neutrality to this paragraph is welcomed.


Also, please think about where we can explain the QA process in detail
most appropriately, i.e. the FlaggedRevs/Wiki-Forum
reviewing/approving process. I'll provide the actual explanation once
AI #3 finally is ironed out.

I guess we can use http://en.opensuse.org/openSUSE:Wiki_Guidelines for
the QA process explanation, or even a new separate page, depending on
the length and complexity of the explanation.

Regards,

R.
--
To unsubscribe, e-mail: opensuse-wiki+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-wiki+help@xxxxxxxxxxxx

< Previous Next >