cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Mike Pogue <>
Subject Re: Cocoon on its new home!
Date Mon, 29 Nov 1999 17:43:09 GMT
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 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

View raw message