Re: [Libreoffice-qa] Updating Whiteboard/Keyword Wiki - Need Input
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 ___ LibreOffice mailing list LibreOffice@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/libreoffice
Re: [Libreoffice-qa] Updating Whiteboard/Keyword Wiki - Need Input
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/
[Libreoffice-qa] Updating Whiteboard/Keyword Wiki - Need Input
Hi All, 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? Thanks all, Joel ___ 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/