From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mga02.intel.com ([134.134.136.20]) by linuxtogo.org with esmtp (Exim 4.72) (envelope-from ) id 1RUiHh-0005Q7-KQ for openembedded-devel@lists.openembedded.org; Sun, 27 Nov 2011 18:12:57 +0100 Received: from orsmga001.jf.intel.com ([10.7.209.18]) by orsmga101.jf.intel.com with ESMTP; 27 Nov 2011 09:06:19 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.67,352,1309762800"; d="scan'208";a="80228446" Received: from unknown (HELO helios.localnet) ([10.252.121.183]) by orsmga001.jf.intel.com with ESMTP; 27 Nov 2011 09:06:19 -0800 From: Paul Eggleton To: openembedded-devel@lists.openembedded.org Date: Sun, 27 Nov 2011 17:06:16 +0000 Message-ID: <15202278.8Gdc2a6et6@helios> Organization: Intel Corporation User-Agent: KMail/4.7.3 (Linux/3.0.0-13-generic-pae; KDE/4.7.3; i686; ; ) In-Reply-To: References: MIME-Version: 1.0 Subject: Re: Documentation problems X-BeenThere: openembedded-devel@lists.openembedded.org X-Mailman-Version: 2.1.11 Precedence: list Reply-To: openembedded-devel@lists.openembedded.org List-Id: Using the OpenEmbedded metadata to build Distributions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 27 Nov 2011 17:12:57 -0000 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" On Sunday 27 November 2011 17:58:00 Frans Meulenbroeks wrote: > What is the problem with being it a wiki (probably with authorized users to > avoid spam). > > I'd say let everyone who wants to contribute. > If someone makes a mistake it can easily be corrected and/or reverted, and > if someone messes things up on purpose and/or creates more bad than good > such a (non)contributor can be banned. > > Disadvantage of a pull model is: > - more difficult to make changes (e.g. if I see a typo in a wiki and I have > write permission, I'll fix it; however if it invokes checking out a file, > make the edit, commit it, mail a pull request, most likely I'll decide it > is not worth the effort > - more administrative workload (that is probably better spent on actually > doing things). > - It sends out a message of distrust. Not really a good way to create > involvement. > > One might feel that it improves quality; then again also in a wiki one can > review and improve (or revert) changes. > > As far as I see it we are all adults (at least I think so) all interested > in improving OE so no unnecessary barriers should be raised. > > Frans. > > PS: it is quite possible to backup a wiki (and I hope this is done at > regular intervals with our wiki). Also all edits are recorded so they can > always be tracked back and (if needed) undone. I agree with all of this. We shouldn't be putting more barriers up to contributing to the documentation - there are already enough. Cheers, Paul -- Paul Eggleton Intel Open Source Technology Centre