Re: getting started - docbook

[Detlef Vollmann <dv@vollmann.ch>]

David Farning wrote:
> 1.1. Linux ................................................
>       1.1.1. Linux Overview ...................
>       1.1.2. Linux Arctoture ...................
>       1.1.3. Linux Development Model..
>       1.1.4. Linux Open Source..............
> 1.2. Embedded Device ............................
>       1.2.1. Device Architure..................
>       1.2.2. Processor..............................
>       1.2.3. Storage.................................
>       1.2.4. Device..................................
> 1.3. Linux Distribution............................
>       1.3.1. Kernel ..................................
>       1.3.2. Userspace.............................
>       1.3.3. File System ..........................
>       1.3.4. Updating ..............................
> 1.4. System startup ..................................
>       ...
> 1.5. Host/Target .......................................
>       ...
> 1.6. Overview ..........................................
> 1.7. History..............................................

This looks like a (more or less general) introduction to
"Embedded Linux".
No problems with that, but make sure not to confuse this with
documentation on how to use OpenEmbedded.

I think there are two different targets for documentation:
  1 - How to use OpenEmbedded
  2 - What to build with OpenEmbedded

There's always a need for both, but I think it's helpful
to keep them separate (but probably reference each other).

Your TOC for an introduction looks like documentation for 2.

   Detlef