[drupal-docs] Handbook v2

Anisa mystavash at animecards.org
Tue Mar 22 14:10:15 UTC 2005


My apologies if I am belaboring any points.

My impression is, from what ya'll have said, and from reading a teeny 
bit about DocBooks and LaTeX is, well, 1) the Drupal Handbook...is NOT a 
600 page science text book.  ^.^;;

2) These things don't deal with the suckiness of the handbook and the 
user oriented documentation.  They basically, correct me if I am wrong, 
apply certain styles to a given text to make it presentable, make it 
easier to update that text and let you see previous versions of that text. 

So, I think of it as the difference between text and css.  In which 
case, it should be possible, even desirable, to work on improving the 
documentation and getting a better ...thingy... for the handbook 
simultaneously. 

The thing is, though, if ya'll are set on rewriting the handbook 
entirely, it's important to establish a style sheet for the 
documentation and have a sense for the organization of the handbook 
(what goes where), as well as know how much impact the potential 
technology will have on the doc writer's ability to organize the 
handbook.  I can't think of anything for that last one off the top of my 
head, but you know, there's always something.  A good stylesheet now 
will help enormously in the transition, since the pages would be 
relatively uniform to start with.

It is worthwhile to set up those new handbook roots, and work from 
there, until this new technology is available, or should the focus be 
instead on just improving the existing handbook until the new technology 
is available?

Anisa.
still procrastinating.





More information about the drupal-docs mailing list