On Sat September 10 2005 6:18 am, lee heng hock wrote: > Hi > > From my personal point of view, the documentation on how to use velocity is > well done but I think the documentation on the installation issues, running > examples and stuff is a bit not user friendly as the docs are scattered > over the place. I dont know but maybe that is how software works..just have > to get used to it.. I think the velocity documentation assumes that you are familiar with how to Tomcat / Java servers work and that you already know how to deploy and write web apps. Which I think is fair enough.
It might be worth having a look to see if there can be a more logical flow to the documentation though. I think you are right in the fact that it is sometimes a bit hard to find what you are looking for as the docs don't always follow the order in which a web-app is developed. I will have a look when i've finished my project and feed back to who ever is in charge of the documentation. It's probably just an organisational thing more than anything. > But it is really gratifying to know there are very nice and helpful people > like Andrew Mason around to lend a helping hand :) *blush* > Regards > David > > On 9/9/05, Andrew Mason <[EMAIL PROTECTED]> wrote: > > In what way is it really really bad? > > > > It took me only a few hours of looking at the docs to make a very usable > > app > > with velocity? There are a few advanced things that could be made > > clearer, or > > added i guess, but most "newbies" don't encounter this stuff immediately. > > > > I'm not part of the dev or documentation team my self, but I think > > velocity is > > quite a well documented project personally so I'd be keen to hear which > > parts > > you found "difficult". I am sufficiently advanced in velocity that i > > could probably help you write up the parts of the documentation your > > having issues > > with. > > > > regards > > Andrew M > > > > > > . > > > > On Fri September 9 2005 3:53 pm, [EMAIL PROTECTED] wrote: > > > May be it is because I'm a newbie, but your velocity's documentation is > > > really really bad. > > > ! > > > > > > > > > > > > > > > --------------------------------------------------------------------- > > > To unsubscribe, e-mail: [EMAIL PROTECTED] > > > For additional commands, e-mail: [EMAIL PROTECTED] > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: [EMAIL PROTECTED] > > For additional commands, e-mail: [EMAIL PROTECTED] --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
