On Sat, 2006-03-04 at 19:04 +0000, Ross Gardler wrote: > Bruno Dumon wrote: > > On Wed, 2006-03-01 at 14:01 +0000, Ross Gardler wrote: > > > >>A couple of weeks ago I promised to set up a FAQ system in Daisy. I've > >>now done this. > >> > >>Creating a FAQ > >>============== > >> > >>There is a "FAQ" document Type. This is a simple document in which the > >>document title should be the question and the content should be the answer. > >> > >>To illustrate things I have copied the "installation faqs" from > >>http://cocoon.apache.org/2.1/faq/faq-install.html into individual FAQ > >>documents, for example: > >> > >>http://cocoon.zones.apache.org/daisy/documentation/799.html?branch=1&language=1 > >>http://cocoon.zones.apache.org/daisy/documentation/806.html?branch=1&language=1 > >> > > > > <snip the details/> > > > >>---- > >> > >>So, if people like this, we should migrate all FAQs from the legacy docs > >>into this format, as well as including relevant ones from the Wiki. > >> > >>Ross > > > > > > Thanks for setting this up. I have some reservations though about > > copying the FAQs from the legacy docs. I haven't read them all but a lot > > of them have become either incorrect or irrelevant. One of the reasons > > for the "new documentation" is that we can leave behind the outdated > > information. > > Yes, that makes sense, I'm a little behind with Cocoon, so do not have > the knowledge to decide what goes in and what stays out. > > > I'd also like to change the > > query in the navigation to a query in a document: having the long > > questions in the navigation doesn't make sense I think. > > +1 > > I only really threw these in as examples. Later I realised I had not > done an example of creating a complete FAQ document (i.e. with questions > & answers) only of indexes (bth navigation and in document). > > None daisy users should be aware that the query system in Daisy is > superb and very flexible. If folk want something better than is > currently in place then just ask how (or do it). >
I now made this of it: http://cocoon.zones.apache.org/daisy/documentation/856.html I've added a forms-related FAQ and a flowscript-related FAQ. > > Similar to the FAQ doctype, I'd also like to set up a "GlosarryItem" > > doctype which can be used to provide short explanations of > > Cocoon-specific terms (such as sitemap, subsitemap, FOM, flowscript, > > blocks, real blocks, ...). > > +1 And the glossary is here: http://cocoon.zones.apache.org/daisy/documentation/857.html -- Bruno Dumon http://outerthought.org/ Outerthought - Open Source, Java & XML Competence Support Center [EMAIL PROTECTED] [EMAIL PROTECTED]