ant-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Shaikh, Mehmood" <Mehmood.Sha...@ccra-adrc.gc.ca>
Subject RE: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!))
Date Thu, 07 Jun 2001 17:23:12 GMT
I found Ant documentation of great help, If it had more than what it has
now, perhaps it would defeat the purpose. However for people who're used to
getting software documentation in the form of a set of books, its a
different matter. 
There is however a need for gathering the various ways people have used Ant
in their projects (I guess thats what they call "Success Stories").

-----Original Message-----
From: Diane Holt [mailto:holtdl@yahoo.com]
Sent: June 7, 2001 12:09 PM
To: ant-user@jakarta.apache.org
Subject: Re: Ant documentation (was: Re: javax.sql.DataSource(Thanks!!))


But here's the problem: We can't know where the doc fails you unless you
tell us -- we're not mind-readers. That's why my initial reply to your
first "failing grade" posting was to ask you where, specifically, the
documentation was insufficient.  People use documentation in different
ways: some people barely even skim through it; others sit down and read it
from beginning to end; and others use it to look for something specific
they need at the moment, get that taken care of, repeat. I tend to fall
into the last category -- ie., I know what it is I want/need to
accomplish, then I look up how, using this particular tool, you do that.

So the question is: How do you use the documentation, and in what way,
specifically, has it failed you?

Diane

--- Suu Quan <squan@wwc.com> wrote:
> This will be my last entry on this topic, I promise, because it's a
> little
> off topic.
> 
> I've got suggestions that instead of whinning why don't I  'raised
> enhancement requests', contribute ....
> But before you say I'm a negative thinker, put yourself in my shoes
> 
> I'm reading the "USER manual" -> I'm new at this stuff -> I"m struggling
> at
> this stuff -> I'm drowning -> I need resucitation,
> I don't know if I'm doing things the way it is intended to, I don't even
> know how it should be (and the manual doesn' t help).
> So, how am I going to 'propose/contribute'.  The only way I know is to
> tell
> this group that the manual is missing those points.
> Until I know what a task is supposed to do, its intended use ..., I
> can't
> ask for an enhancement/fix.
> 
> And the argument that bothers me the most: this is contributed software,
> and
> contributed time. This is open software.
> When I start a job, I try to do it right. Whether I get paid for it or
> not
> does not affect my quality standard. That's the way I am. I'm just
> shocked
> at the justification that since you didn't pay for it, don't expect
> much.
> Not from Open Software.
> 
> Now I shut up, for good.
> 


=====
(holtdl@yahoo.com)



__________________________________________________
Do You Yahoo!?
Get personalized email addresses from Yahoo! Mail - only $35 
a year!  http://personal.mail.yahoo.com/

Mime
View raw message