3) Documentation - Good solid reference examples of how to do do simple apps, explained in detail. Most developers want a framework to be like lego building blocks. I do A, B, C and D and I get E. I assemble a dozen different pieces and I have my app. Really how complicated are most web apps? They are forms and workflow and validation. To get developers to use your framework you need good examples of how to do each, laid out and described in simple guaranteed to work steps. There need to be examples of these in both Netbeans and Eclipse; preferably several examples of each.
----------- All good points, but this above all others I think. Developers never seem to fully appreciate this - or if they do, they make it a lesser priority. Documentation is critical. It doesn't matter how good something is (and that those "in the know" know it), it's rendered useless if the documentation doesn't exist or is not up to scratch. Tapestry 5 documentation is not up to scratch. I'll repeat that: Tapestry 5 documentation is not up to scratch. Why? Unfortunately there are a plethora of places to look in if you want to find how to do something. It's not only annoying for people who are developing in Tapestry, it is off-putting to new developers who are looking at this as a possible solution to a development problem. We've now reached a stage in web development where things should be easy to put together (Lego building blocks). I used to hate web development and Tapestry 3 was the first thing I found which helped me dislike it a lot less. Tapestry 5 even more so. However, having no good set of central documentation, how-tos, cookbook solutions, etc makes the development process that much harder and not like Lego blocks. I really only want to have to think about business logic and know only the basics of how Tapestry works. Turning to the source code should be a last resort and I've had to do that once so far with Tapestry 5 because the documentation I required was inadequate (can't remember what it was now, but it wasn't even anything exotic I was trying to do!) That said, I think this mailing list is fantastic and has certainly ridden to my rescue on numerous occasions. The only off-putting thing is the fear of asking the "dumb question". Sure, no questions are dumb, but I always feel a lot better if I know I've made an effort to find out how to do something before asking on here. Again, lack of good docs makes that effort so much harder and also increases the traffic on here by the same questions being asked multiple times. ************************************************************************** Experience the British Library online at www.bl.uk The British Library's new interactive Annual Report and Accounts 2007/08 : www.bl.uk/knowledge Help the British Library conserve the world's knowledge. Adopt a Book. www.bl.uk/adoptabook The Library's St Pancras site is WiFi - enabled ************************************************************************* The information contained in this e-mail is confidential and may be legally privileged. It is intended for the addressee(s) only. If you are not the intended recipient, please delete this e-mail and notify the postmas...@bl.uk : The contents of this e-mail must not be disclosed or copied without the sender's consent. The statements and opinions expressed in this message are those of the author and do not necessarily reflect those of the British Library. The British Library does not take any responsibility for the views of the author. ************************************************************************* --------------------------------------------------------------------- To unsubscribe, e-mail: users-unsubscr...@tapestry.apache.org For additional commands, e-mail: users-h...@tapestry.apache.org
