[drupal-docs] Handbook 2

[Vladimir Zlatanov]

>....
> have to make a mode-switch to using an offline tool to do docs.
> 
> I believe there are tools available to go HTML -> DocBook.
With careful style guidelines and/or rigid filtering the current book module
can be made to generate docbook directly, similar to the printer 
friendly view. I don't know docbook well enough to be able to do that,
but if someone comes up with dupal book - docbook conversion guide, i.e.
how do you define a section, subsection, etc... I can help with that.

> > > I have two ideas.
> > > 1. We go ahead with making new books, along the lines suggested in
> > > the wiki set up for handbook 2.  Establish style guidelines.  We set
> > > up a wiki appropriate for documentation that is easy to use so that
> > > people can rewrite and revise old handbook pages.  No automatic
> > > updating, but updating wouldn't be so bad.
+1
> > > 2. This may be totally yokei, but could we make a better handbook if
> > > we made it through a tightly controlled taxonomy with pages/special
> > > node type instead of using the book module? Anisa.
> I think this needs more fleshing out. I think the book module is
> appropriate for documentation. Is there a way that a cross-index could
> be applied with taxonomy terms? Perhaps, can't quite think how that
> would work at this point. Also, more stalling while this gets
> developed...
Taxonomy will come handy for cross-referncing topical pages from
different sections of the handbook and (possibly) drupal forums

Vlado