Date: prev next · Thread: first prev next last
2013 Archives by date, by thread · List index


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

-- 
To unsubscribe e-mail to: users+unsubscribe@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/users/
All messages sent to this list will be publicly archived and cannot be deleted

Context


Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License (MPLv2). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.