cocoon-dev mailing list archives

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

-----Original Message-----
From: Mike Pogue <mpogue@apache.org>
To: cocoon-dev@xml.apache.org <cocoon-dev@xml.apache.org>
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.
>
>Mike
>
>Pierpaolo Fumagalli wrote:
>>
>> From: Stefano Mazzocchi <stefano@apache.org>
>> >
>> > 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
Hardenbrook
>> (our tech writer, who had no experience on XML documentation before),
Mike
>> Pogue (my manager), and me designed them to allow untrained people to
pick
>> 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
>


Mime
View raw message