Bertrand Delacretaz wrote: > Diana Shannon a �crit : > > <lots-of-cool-stuff-snipped/> > > > ...- separate out all docs relating to project administration, > > licensing, etc. Keep a single instance of these somewhere. Maintain > > these in xdocs. Refine/edit/refactor as approach > > Let me reformulate to make sure we're in sync: > Keep the xdocs to the bare minimum: project info, sitemap and > components reference, that's it?
Core conceptual documentation would also belong in this group. > All the rest (tutorial, examples, how-tos) is found on the "other doc > system" mentioned below. > > > - Refactor our reference docs to be produced by some kind of > > auto-generation mechanism... > > ok - I think we had a nice concept here. > (and the Chaperon parser could certainly help a lot for this but let's > not talk about tools ;-) > > > - Leave all the rest -- How-Tos, FAQs, Tutorials, Concepts -- to a > > more open content system (via wiki/PHP-notes-like/simple CMS, > etc.).... These docs can then directly reference the well-controlled core documentation, thus not needing to explain basic concepts over and over. --David
