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 _______________________________________________ yocto mailing list yocto@yoctoproject.org https://lists.yoctoproject.org/listinfo/yocto