[documentation] Brainstorming a new documentation method

[Victor Kane]

On 8/22/07, add1sun <drupal at rocktreesky.com> wrote:
>
> ...


Just wanted to comment that should a lot of editing have to be done with
DocBook, the DTD can be downloaded and installed, and even customized for
Drupal (just a subset of DocBook, I imagine), and then the Eclipse xml tools
can use it to make a really snappy, table view interface which will be of
great assistance. With the Eclipse web tools add-on you get an excellent XML
editor, which allows the XML to be edited as a table, and which will not
allow you to break the DTD or schema rules.

So we can create a free open-source environment to work with DocBook, once
you get used to it, it is quite easy.

since it will be in
> DocBook format and in CVS - not normal handbook pages.  Replicating
> the entire community-contributed handbook for each version is really
> not feasible at this time. ...


Some of that work can be automated, and that might make it feasible. There
are many available DocBook editors and tools, also.

saludos,

Victor Kane
http://awebfactory.com.ar
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20070823/ef9a6204/attachment.htm