Hi Joel,
On Tue, Oct 22, 2013 at 06:46:34PM -0700, Joel Madero wrote:
> I'm going to be updating the wiki for whiteboard and keyword to make
> it more legible. There has been talk about taking a minimilistic
> approach to the wiki, less formal, less "rules" (although we don't
> have rules, just guidelines), this vs. the "comprehensive, answers
> any question someone might have" approach. My question is, which is
> preferred? Should I strip the wiki to the minimum with very basic
> info or include the details needed where someone could technically
> use the wiki without additional input in a relatively cohesive way?
IMHO on the wiki, it only makes sense to have a 'staged description' of
whatever workflow. That is, have one description that covers the usual case
short and sweet and a second page/section with all the gory details. Both
should link to each other of course.
This is to:
- not scare away newcomers with too much detail
- allowing people to add details without bitrotting the short description into
a long and winding one.
see also: https://en.wikipedia.org/wiki/Pareto_principle
Best,
Bjoern
___
List Name: Libreoffice-qa mailing list
Mail address: Libreoffice-qa@lists.freedesktop.org
Change settings: http://lists.freedesktop.org/mailman/listinfo/libreoffice-qa
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://lists.freedesktop.org/archives/libreoffice-qa/