[oe] getting started - docbook

[Stelios Koroneos]

> In my humble opinion that is way out of scope for a OE documentation.
> The point is to present the workings and functionalities of OpenEmbedded
> and not how to get some arbitrary hardware to run linux from 0 to
> 100% .. ?
>
> At least that is my conception of what the OE documentation should
> provide?


We discussed the documentation matter in OEDEM.
What we "concluded" to is that there can not be a single document to cover
all of OE
The idea was to see how we can get a "Getting started guide" where the basic
functionality of OE is covered and a "Programmers/Developers manual" kind of
thing where all big and little dirty details of OE should go to.

These two documents target different kind of people with different needs.
The people who would like to use OE with an existing device/distro by simply
building an image and/or want to develop/port an application (without
messing too much with the OE internals) and those who need to add a new
device/distro/extend OE in whatever manner they need

IMHO there is a need to get documentation for the larger pool of
"application developers" first and move into the detailed "board/distro
developers" at a second stage, as we are going to see more and more of the
first, as OE gets shipped with more and more devices.
And with the SDK needing some "final touches" to be functional , we are
bound to see more and more people asking questions that are "application
developer" oriented, so we better be prepared for that.



Stelios S. Koroneos

Digital OPSiS - Embedded Intelligence
http://www.digital-opsis.com