[yocto] trying to summarize all the top-level yocto-related docs

[Robert P. J. Day]

  in trying to resolve a minor issue this weekend regarding
PREMIRRORS, i tried to summarize the current set of yocto-related docs
and wound up just a bit confused so i'm hoping someone can clarify the
canonical set of documentation someone getting into yocto would want
to have.

  as i read it, one can look at yocto in a series of intellectual
layers, simplest to most complex:

  * bitbake
  * OE-core
  * poky
  * yocto

  first, is that a reasonable way to look at the software collection?
if so, how do the docs line up against this?

  first, there's the bitbake user manual here:

  http://bitbake.berlios.de/manual/index.html

it seems like that manual hasn't been updated for a while (or has
it?).  is that the current state of the documentation for bitbake?  it
seems incomplete, unless i'm unclear on how the software is broken up.

  next, there's OE-core, for which the wiki page seems to be the most
current doc:

  http://www.openembedded.org/wiki/OpenEmbedded-Core

moving on to poky, the web site http://pokylinux.org/ really doesn't
take care to distinguish between poky and yocto since the "About" link
immediately jumps one over to the yocto project "About" page, which
really blurs the line between poky and yocto, deliberately or
otherwise.

  as for poky documentation, the Documentation tab over at yocto has a
link to the "Poky Reference Manual" but there is also a Poky Handbook
which is *not* linked from there and is not even clearly linked from
the poky site itself -- here's the handbook:

  http://pokylinux.org/doc/poky-handbook.html

which is clearly back at the poky site but you would be hard-pressed
to find that handbook starting at the poky linux main page and
following links.

  so ... what is the state of docs and support these days, for both
documentation and mailing lists?  i was wondering about something
involving PREMIRRORS and i ended up unsure as to what to read or which
mailing list i could consult.

  thoughts?

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================