I might be willing to be the "Ant documentation guy". I am a dot-com refugee (recently laid off), so I've got some free time, and I had been wanting to contribute. I am only slightly familiar with anakia, but xml/xsl isn't a problem, so I could probably learn stylebook pretty easily. Where can I get the docs for using stylebook, or where can I check out the stylbook cvs module? I seem to remember that the stylebook cvs repository is buried someplace hard to find.
Sincerest regards, Chris Todd [EMAIL PROTECTED] 410-740-1409 >-----Original Message----- >From: Peter Donald [mailto:[EMAIL PROTECTED] >Sent: Tuesday, February 06, 2001 9:52 AM >To: [EMAIL PROTECTED] >Subject: Re: New manual organization > > >At 01:30 7/2/01 +1100, Conor MacNeill wrote: >>As Jesse Glick has pointed out, the index.html file is too large and also >>difficult to maintain. I think our long term direction is to have >some form >>of structured documentation system, perhaps based on stylebook or >Anakia. I >>don't know enough about those yet to know what is reasonable or >applicable. > >both/either are reasonable and applicable IMHO ;) Just as long as some one >takes charge of keeping process done. If we go with stylebook then I can >handle that (mainly playing with xslt) however anakia is fine (and faster) >if we just use the jakarta-site2 as a dependency. Thou if we want to >transform arbitrary xml docs (ala taskdocs DTD instances) then we need >someone who is happy to work with velocity which looks simple enough. > >>In the interim, I have reworked index.html into a collection of >HTML files, >>one per task. You can find my updated version here >> >>http://jakarta.apache.org/~conor/ > >I like it ! Great work .. must of taken a while ;) > >>At this time, the major change you will notice is on the "built-in tasks" >>link. > >Note that the heading still exists in main document. > >>A similar approach for optional tasks is of course possible. > >and very desirable ;) > >>I am looking for feedback on this approach and whether we should >adopt this >>for the 1.3 release. > >I think it would be a good idea though it is largely up to you being that >you are release manager ;) > >Cheers, > >Pete > >*-----------------------------------------------------* >| "Faced with the choice between changing one's mind, | >| and proving that there is no need to do so - almost | >| everyone gets busy on the proof." | >| - John Kenneth Galbraith | >*-----------------------------------------------------* > > >--------------------------------------------------------------------- >To unsubscribe, e-mail: [EMAIL PROTECTED] >For additional commands, e-mail: [EMAIL PROTECTED] >
