2008/11/11 Callum Gibson <[EMAIL PROTECTED]>: > On 11Nov08 15:43, Elvis Stansvik wrote: > }I have started to reconsider the structure of the main content (yet to > }be written). Maybe it should be more task oriented and not sectioned > }by the different APIs? > > I like the original outline - it's logical to group the APIs together and > your section immediately preceding "Choosing the Right API" will help. > Perhaps what you're thinking of can be catered for by a "how to" page > of tasks and these could link back to the examples for each API. > > After all, this isn't a real book so you're not limited by a linear format > and you can reuse material by referring to it from multiple places. Your > initial outline and table of contents is just one suggested reading order. > > The only other thought I had on wiki vs docbook is that docbook is probably > easier to setup a structure initially and to refactor in the case of major > restructuring of sections, but these are tasks best done by one person anyway > (which you're doing). A wiki is going to be much better for keeping it > up to date and content rich though.
Alright, makes sense. Thanks for your input Callum. Elvis > > C > > -- > > Callum Gibson @ home > > _______________________________________________ > xml mailing list, project page http://xmlsoft.org/ > xml@gnome.org > http://mail.gnome.org/mailman/listinfo/xml > _______________________________________________ xml mailing list, project page http://xmlsoft.org/ xml@gnome.org http://mail.gnome.org/mailman/listinfo/xml