[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