ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Chris Todd" <>
Subject RE: New manual organization
Date Tue, 06 Feb 2001 17:37:35 GMT
Never mind about the location of the xml-stylebook module, I found it.  Just
let me know if you want me to handle xml-izing the ant docs.

Sincerest regards,
Chris Todd

>-----Original Message-----
>From: Chris Todd []
>Sent: Tuesday, February 06, 2001 12:21 PM
>Subject: RE: New manual organization
>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
>>-----Original Message-----
>>From: Peter Donald []
>>Sent: Tuesday, February 06, 2001 9:52 AM
>>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
>>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
>>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"
>>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 ;)
>>| "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:
>>For additional commands, e-mail:
>To unsubscribe, e-mail:
>For additional commands, e-mail:

View raw message