[drupal-docs] Handbook 2

[Djun Kim]

Quoting Anisa <mystavash at animecards.org>:

> I thought I'd wait it out, but waiting is boring.  ^.^
>
> So, as far as I know, someone was looking into DocBooks/LaTeX.  
> Features requests were filed for the book module, but it is unknown 
> if anyone is actually working on it, no patches have been submitted.
>


    Pardon me for parachuting in here, but was the intention
to have documentation contributed/edited in the form of
publication markup such as Docbook or LaTeX?

    If so, I have a fair amount of experience with both Docbook and
TeX/LaTex, and have been interested in trying to get something
along these lines working for the book module also.  I have a
fairly immediate need in the form of a project I'm working on
that requires shared editing of technical content
(mathematics) for print publication.  Hence, I'd be willing to
commit to helping move this project along.

    I have certain reservations about inflicting technical
typesetting on the general population, though.  Seeing naked
XML or LaTex may be scare away potential contributors.


> 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.
>
> 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.
>


-- 
Dr. Djun M. Kim, Director                       djun.kim at cielosystems.com
Cielo Systems Inc.                              http://www.cielosystems.com
Strategic Software Research                     Tel:   (604) 739-3941
302 - 1298 10th Avenue West                     FAX:   (604) 739-3943
Vancouver, BC, V6H 1J4                          Mobile:(778) 895-1379