Looking at the "Lego" part at http://wiki.maemo.org/Developer_Guide_table_of_contents it says "Flow Suggestion - Start with 'upstream' and core linux".

I think this summarizes the approach of the current ToC, and perhaps our collision of opinions. Shouldn't be the other way around? First you have the Maemo API (mostly the Qt frontend) and only if you really are interested in more you go down to kernel etc.

The Developer Guide must put the emphasis on what newcomers need to get started. Any developer with a more advanced knowledge will sooner or later find what he is looking for.

This is why I believe it's worth to start with an intro that even a non-developer could find interesting, continue with easy WebRuntime that even someone that is into web development can give a try, and finally get into native development.

The platform description would be out of scope in the Developer Guide, a separate guide.

I'll draft a ToC in the discussion page since I see my schematic proposal here isn't enough to convince.