[drupal-docs] Handbook v2

[Boris Mann]

On Mon, 28 Mar 2005 22:49:49 +0900, Anisa <mystavash at animecards.org> wrote:
> I believe it was stuck at a crossroads sort of point.  One way was to
> modify the current book module to suit certain needs as outlined in
> Boris's original page, the other was to import in LaTeX/DocBooks.
> People seemed excited at the idea of importing in DocBooks, but I don't
> believe anyone actually took it up.  At that point, the discussion
> rather stalled.

Changes to book can still be made outside of any DocBook stuff. At the
end of the day, we still need web-based representation of docs,
although I presume the plan would be to export from DocBook.

> > Did we made any progress?  The sooner we figured out how to write
> > (i.e. what tools to use), the sooner we can start writing (and
> > migrating content).  IMO, this should be the documentation team's
> > current focus.

I can tell you right now, that doc efforts WILL slow. *Someone* needs
to go out and investigate all the different options. We had a couple
of suggestions, but nobody actually went out and tried them.

I'm not going to put out any arguments against offline formats like
DocBook -- it's a good idea if someone runs with it. I know *I* don't
have time to do the necessary research.

I also know that offline documentation is a mode switch -- I can
easily spend a few minutes editing something web-based, but starting
up a doc writing package (potentially with a CVS update/checkout
somewhere along the way) will take much more time, and I will have to
devote larger chunks of time to actually doing documentation.

So, there's my 2¢ for now. We've got a busy week (weeks?) ahead.
Roland and Richard continue to do Documentation Thursdays. We'll help
with any efforts, but won't be leading the charge on any DocBook
stuff.

--
Boris Mann
http://www.bryght.com