Well, that's your attitude Andrew. As Daniel pointed out, SUN provides
online documentation for all their JDKs. Similarly, JUnit provides online
documentation for all its released versions. I, for one, appreciate this and
find that it's a PITA ANT doesn't provide the same convenience to its user.
That ANT 1.5 beta is release-quality (whatever that means for a beta
version!) is irrelevant. The current stable version of ANT should always be
documented online, as should *any* released version of ANT. --DD

-----Original Message-----
From: Andrew C. Oliver [mailto:[EMAIL PROTECTED]] 
Sent: Monday, May 06, 2002 11:55 AM
To: Ant Users List
Subject: Re: Ant 1.5 Beta documentation online

My attitude is this... The purpose of the website is to engage people in 
the project...  The purpose of the documentation in the release build is 
to document that release.  So the website should be bleeding edge...the 
release docs should match the release.

-Andy

Daniel Barclay wrote:

>
>>From: Erik Hatcher [mailto:[EMAIL PROTECTED]]
>>...
>>I consider Ant 1.5Beta1 "release" quality, personally.  So 
>>far there have
>>been no show-stopper issues and we are encouraging everyone 
>>to upgrade so
>>that we can get it thoroughly hammered before it goes to 
>>release.  
>>
>
>Does the Ant project have a policy on which version of the
>documentation should be the (default) documentation on the
>web site?  If not, it probably should (so it's not a question 
>of who people considers it release-quality or not released yet).
>
>
>
>>Because
>>of this, I'm happy to see that the website now has the 
>>1.5Beta1 docs online.
>>
>
>Just to be clear, I wasn't suggesting that the new documentation
>shouldn't be on the web site, just that it shouldn't replace the
>documentation for the current (last released) version.  
>
>You could do it the way Sun does:  The documentation for JDK 1.2
>and JDK 1.3 was (and is) still accessible (without downloading and 
>unpacking)on their web site when 1.4beta and then 1.4.0 came out.
>
>
>
>
>Daniel
>--
>To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
>For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
>
>--
>To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
>For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
>
>




--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to