improving the manual

2005-07-30 Thread Roedy Green
I am working on some material I hope to post this weekend at http://mindprod.com/jgloss/ant.html Canadian Mind Products[EMAIL PROTECTED] #327 - 964 Heywood Avenue Victoria, BC CANADA V8V 2Y5 http://mindprod.com roedy green(250) 361-9093 emergency --

Re: Improving the manual

2005-07-28 Thread Simon Chappell
On 7/28/05, Steve Loughran <[EMAIL PROTECTED]> wrote: > Simon Chappell wrote: > > On 7/27/05, Roedy Green <[EMAIL PROTECTED]> wrote: > > > >>The big problem with the Ant manual is the people who wrote it knew > >>too much. I can see various ways to make it more intelligible to the > >>first timer:

Fwd: Improving the manual

2005-07-28 Thread Simon Chappell
I'd be dangerous if I was clever. This was meant to go to the list, not just to Jay. I may not be a newbie, but I can act like one somedays. :-) -- Forwarded message -- From: Simon Chappell <[EMAIL PROTECTED]> Date: Jul 28, 2005 10:11 AM Subject: Re: Improving the man

RE: Improving the manual

2005-07-28 Thread Jay Burgess
Jay | Jay Burgess [Vertical Technology Group] | "Essential Technology Links" | http://www.vtgroup.com/ -Original Message- From: Simon Chappell [mailto:[EMAIL PROTECTED] Sent: Thursday, July 28, 2005 9:47 AM To: Ant Users List Subject: Re: Improving the manual On 7/27/05, Roedy Green &

Re: Improving the manual

2005-07-28 Thread Steve Loughran
Simon Chappell wrote: On 7/27/05, Roedy Green <[EMAIL PROTECTED]> wrote: The big problem with the Ant manual is the people who wrote it knew too much. I can see various ways to make it more intelligible to the first timer: Well, I actually like the Ant manual just the way it is. I find it ve

Re: Improving the manual

2005-07-28 Thread Simon Chappell
On 7/27/05, Roedy Green <[EMAIL PROTECTED]> wrote: > The big problem with the Ant manual is the people who wrote it knew > too much. I can see various ways to make it more intelligible to the > first timer: Well, I actually like the Ant manual just the way it is. I find it very useful and I get pr

Re: Improving the manual

2005-07-28 Thread Juergen Hermann
On Wed, 27 Jul 2005 10:18:14 -0700, Roedy Green wrote: IMHO the right place to start this is the wiki, especially since everyone can right now start to contribute, there are no obstacles. Whether the content created there is then incorporated into the docs or not is not so important, HAVING the

AW: Improving the manual

2005-07-27 Thread Jan.Materne
Good to hear some suggestions from another point of view :-) >The big problem with the Ant manual is the people who wrote it >knew too much. I can see various ways to make it more >intelligible to the first timer: Contributions are welcome, we love to increase the usability of Ant. >1. def

Re: Improving the manual

2005-07-27 Thread David A. Bartmess
I would be willing to help, since even being a somewhat-seasoned (garlic anyone?) Ant developer, I STILL have problems reading the manual and getting info on what I need it to DO, not what the parameters are! At 11:18 AM 7/27/2005, you wrote: The big problem with the Ant manual is the people wh

RE: Improving the manual

2005-07-27 Thread Daniels, Doug
pics need to be explained. -Original Message- From: Roedy Green [mailto:[EMAIL PROTECTED] Sent: Wednesday, July 27, 2005 1:18 PM To: user@ant.apache.org Subject: Improving the manual The big problem with the Ant manual is the people who wrote it knew too much. I can see various ways

Improving the manual

2005-07-27 Thread Roedy Green
The big problem with the Ant manual is the people who wrote it knew too much. I can see various ways to make it more intelligible to the first timer: 1. define a term like project or target the first time it is used. Don't even presume people know what MAKE is. Ant should be accessible to p