On Mon, 2 Apr 2001, Morgan Delagrange wrote:
> If I had my druthers, I'd use XSLT for the docs as
> well. Maybe I'll try doing the Commons site docs in
> XSLT initially and we'll see how it goes.
To be honest I'm more concerned about using stylebook over docbook
( and the fact that many apache projects are doing so is even more
concerning ).
XSLT is not the only way to transform documents - it have the benefit of
beeing a standard, but it's something that is part of the process of
building the site.
Stylebook is something that commiters are supposed to use to document
their code - and so far I don't remember any vote ( on ignoring the
existing formal and de-facto standards for documentat authoring and using
an apache-specific DTD )
Costin
>
> --- [EMAIL PROTECTED] wrote:
> >
> > > > Anyway if you decide to go with stylebook I have
> > the jakarta-style which I
> > > > can move into jakarta-site CVS but I would
> > recomend you use Anakia anyways
> > > > (but then again me and xslt hate each other ;]).
> > >
> > > I'm actually reasonably comfortable with XSLT, but
> > Anakia would be OK too
> > > (and preferable to stylebook IMHO). I'm also
> > hoping someone else will
> > > focus on the web site part of this :-).
> >
> > I don't want to open any war here, but IMHO we
> > should recomend using
> > standard-based solution ( like XSLT and docbook ).
> >
> > I have no problem with using other solutions, like
> > anakia or stylebook,
> > but I can't agree with making them the "default" or
> > "recomended" solution.
> >
> > Docbook is a standard for documentation, used in
> > most open source
> > projects ( Linux, KDE, and countless other ),
> > defined by Oasis. XSLT is a
> > standard defined by W3C for document transformation.
> >
> >
> > It is very likely that stylebook is "easier" and
> > anakia is "faster" -
> > and that would be an argument for using them, but I
> > see a big problem
> > with Apache starting to define standards competing
> > with W3C - next step
> > would be maybe an A-HTTP that is faster/easier than
> > HTTP/1.1 ?
> >
> >
> > Costin
> >
> >
> >
> >
>
>
> =====
> Morgan Delagrange
> Britannica.com
>
> __________________________________________________
> Do You Yahoo!?
> Get email at your own domain with Yahoo! Mail.
> http://personal.mail.yahoo.com/?.refer=text
>
