[yocto] <rant>the current yocto FAQ is pretty much valueless</rant>

[Darren Hart]

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