Re: <rant>the current yocto FAQ is pretty much valueless</rant>

[Tomas Frydrych <tf+lists.yocto@r-finger.com>]

On 26/06/12 10:09, Robert P. J. Day wrote:
> A bad Frequently Asked Questions (FAQ) sheet is one that is composed
> not of the questions people actually ask, but of the questions the
> FAQ's author wishes people would ask. Perhaps you've seen the type
> before:

Nice quote, but unfortunately based on the literal meaning the acronym
rather then insight into the function of a FAQ; asking the right
questions is far more important than finding answers ... ;-)


> "how can i use the yocto prebuilt toolchains to save build time?"

Perhaps your question is not asked frequently enough to merit inclusion
in a FAQ, or perhaps it's an a far too advanced topic for a FAQ?


>   a *bad* FAQ would be:
> 
> "Does the Yocto Project have a special governance model, or is it
> managed as an open source project?"

Just because you are not interested in the answer does not make it a
question you should think about ...


>   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*.

There are two correct answers to this: the first one is RTFM; the second
one is that if you want an explicit link to the section of the manual
that explains it to be included in the FAQ, you should write the
appropriate entry for the FAQ and contribute it instead of ranting on
the list.

Tomas