ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Chris Todd" <chris.t...@home.com>
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
chris.todd@home.com
410-740-1409


>-----Original Message-----
>From: Chris Todd [mailto:chris.todd@home.com]
>Sent: Tuesday, February 06, 2001 12:21 PM
>To: ant-dev@jakarta.apache.org
>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
>chris.todd@home.com
>410-740-1409
>
>
>>-----Original Message-----
>>From: Peter Donald [mailto:donaldp@apache.org]
>>Sent: Tuesday, February 06, 2001 9:52 AM
>>To: ant-dev@jakarta.apache.org
>>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: ant-dev-unsubscribe@jakarta.apache.org
>>For additional commands, e-mail: ant-dev-help@jakarta.apache.org
>>
>
>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: ant-dev-unsubscribe@jakarta.apache.org
>For additional commands, e-mail: ant-dev-help@jakarta.apache.org
>


Mime
View raw message