Re: DocBook DTD


Guylhem Aznar (guylhem@metalab.unc.edu)
Wed, 12 Jan 2000 13:05:56 +0100


On Wed, Jan 12, 2000 at 10:49:18AM +0100, Stephane Bortzmeyer wrote:
> Again, this is falsified by the facts. The Debian documentation is in
> DebianDoc, *all* the HOWTO are in LinuxDoc and it works (it could work
> better but saying that it is of "no real usefulness" is name-calling
> only).

We have different formats and everything works.

Question is: should we take the risk of moving to a common format,
loosing time, authors and credibility?

> > The time has come to bite the bullet, and start the conversion
> > process (hell, LDP is most of the way there already)
>
> Not *one* HOWTO have been converted and maintained in DocBook form.

You're right, we haven't converted a single HOWTO yet.

But we have a workgroup which is weighting pro & cons (and writing
scripts for test purposes) before moving to docbook.

And if one day we move to something different from linuxdoc for HOWTOs,
we want :
 - scripts for a flawless conversion by each author (they didn't ask for a
   new format, so let's make the change easy)
 - a format which will be used by other documentation project as well.

DocBook is a good candidate, I previously discussed it with K DP leader
and they did choose DocBook too.

Indexation to design a knowledge base is also very important for us, it
could be done with DocBook.

What else should we choose?

-- 
Guylhem Aznar, Linux Documentation Project: http://www.linuxdoc.org
------>>> Attention, my new email is guylhem \@/ metalab.unc.edu
"They who can give up essential liberty to purchase a little temporary
safety, deserve neither liberty nor safety." - Benjamin Franklin 



This archive was generated by hypermail 2.0b3 on Wed Jan 12 2000 - 17:46:08 EST