From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by yocto-www.yoctoproject.org (Postfix) with ESMTP id 6F671E0070C for ; Tue, 26 Jun 2012 08:48:10 -0700 (PDT) Received: from orsmga001.jf.intel.com ([10.7.209.18]) by orsmga101.jf.intel.com with ESMTP; 26 Jun 2012 08:48:10 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.67,352,1309762800"; d="scan'208";a="158407619" Received: from unknown (HELO envy.home) ([10.255.12.246]) by orsmga001.jf.intel.com with ESMTP; 26 Jun 2012 08:48:09 -0700 Message-ID: <4FE9D965.4070906@linux.intel.com> Date: Tue, 26 Jun 2012 08:46:45 -0700 From: Darren Hart User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:13.0) Gecko/20120615 Thunderbird/13.0.1 MIME-Version: 1.0 To: Paul Eggleton References: <10398861.esnekvBoZU@helios> In-Reply-To: <10398861.esnekvBoZU@helios> X-Enigmail-Version: 1.4.2 Cc: yocto@yoctoproject.org Subject: Re: the current yocto FAQ is pretty much valueless X-BeenThere: yocto@yoctoproject.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: Discussion of all things Yocto List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 26 Jun 2012 15:48:10 -0000 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit On 06/26/2012 03:09 AM, Paul Eggleton wrote: > On Tuesday 26 June 2012 05:09:34 Robert P. J. Day wrote: >> in other words, a *good* FAQ might be: >> >> "how can i use the yocto prebuilt toolchains to save build time?" >> >> a *bad* FAQ would be: >> >> "Does the Yocto Project have a special governance model, or is it >> managed as an open source project?" >> >> the kicker is that that last question is, in fact, in the yocto FAQ, >> along with a number of other questions that have never been asked by >> anyone in the history of the planet. i chat about yocto with people >> on a regular basis, and i can assure you, not a single one of them has >> ever asked, "hey, rob, can you explain yocto's governance model?" >> >> no, what they ask is, "hey, rob, how can i add a single package to >> an existing target?" a question that, i should point out, is not >> answered definitively in the existing docs *anywhere*. > > You bring up a valid point, but I think it might be worth mentioning that the > current FAQ evolved from a much less technically-oriented version that was > produced when the project launched. At that time some people *were* asking the > kind of questions that you're deriding. I think there's still a section of the > *non-technical* audience who are interested in answers to those questions. > > I suggested to Scott R previously that it might be worth having a project FAQ > (i.e., what is this project about, what is it intended to be used for etc.) > and a separate technical FAQ which answers the kind of questions you are > expecting and that we see often on the mailing list. I think one of the > reasons that hasn't been done is that we're hoping to introduce a Q&A function > on the website similar to StackOverflow, where everyone can participate but the > most appropriate answers bubble up to the top. As yet this has not been > implemented and I'm not sure when it will be, so it may still be worth looking > into a static technical FAQ on the wiki until it is. Is "technical FAQ" == "How-Do-I pages" ? -- Darren Hart Intel Open Source Technology Center Yocto Project - Linux Kernel