cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Nader Aeinehchi" <>
Subject Where can I find DocBook /StyleBook@Ibm?
Date Tue, 30 Nov 1999 09:44:59 GMT

-----Original Message-----
From: Mike Pogue <>
To: <>
Date: Monday, November 29, 1999 7:45 PM
Subject: Re: Cocoon on its new home!

>I agree.  DocBook is WAY too complex for most needs.
>BTW, we have about 6 or 8 people using the Stylebook tagset for docs
>now.  Feedback has been good so far.  All have ben able to pick it up by
>example, without any real docs yet.
>Pierpaolo Fumagalli wrote:
>> From: Stefano Mazzocchi <>
>> >
>> > I evalutated DocBook a while ago, but I found it utterly
>> > overcomplex for our needs.
>> I spent almost one month crashing my head down on DocBook (when we first
>> thought about StyleBook @ IBM!)... We had the same idea... Too much
>> complexity and too few flexibility...
>> The DTDs we uses for XERCES documentation (and currently for all the
>> XML.APACHE.ORG website), were designed exactly for that. Susan
>> (our tech writer, who had no experience on XML documentation before),
>> Pogue (my manager), and me designed them to allow untrained people to
>> them up easily...
>> We were so much conforted when Andrew (our second tech writer, that just
>> joined our team) picked them up and started using them correctly with
>> basically no training... Our goal was successful :)
>>     Pier

View raw message