tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Ignacio J. Ortega" <>
Subject RE: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatD ocu mentation Redactors To Hire]
Date Mon, 02 Jul 2001 21:52:43 GMT
> We should try to hire some XML/XSL writers which could send us 
> skeleton XML and XSL ?)

Look a everyother project ( almost ) in Jakarta, a quick peek will give
a brief of what is doing people , and almost everybody is documenting
projects in xml.., doing the processing in a mix of anakia/plain xsl..

So Jakarta is plenty of good examples ( better look at our brother TC4.0
or Struts i think they are doing his docs in plain XML/XSL)

I'm +0 in xml efforts ( i'm writing my own docs in DocBook from some
time ago, i'm used to nwalsh stylesheets btw ),

But i share concerns expressed by Costin,  

so in this moment i'm totally +0 in this regards..

> It won't be much harder to edit XML with VI than HTML with
> NS/FP/DW ....
> I guess will have replies soon :)

TO write xml by hand can be a class of pain i do not recommend to
anybody.., but not worse than to write html by hand.. and perhaps
easiest than html.., but not with DocBook.... it's far bigger than the
average human needs :), I think StyleBook is a subset of DocBook .., 

Pier can comment on this i think him was one of the StyleBook creators.

Saludos ,
Ignacio J. Ortega

View raw message