Yup, its true the only problem of Tapestry 5. It lacks full documents that can help many newbies to learn this framework.
As long as its FREE I will be a Tapestry lover... Not all things in this world is EASY! Newham, Cameron wrote: > > 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 > > > -- View this message in context: http://old.nabble.com/T5%3A-What-is-NOT-beautiful-about-Tapestry--tp23304774p26603363.html Sent from the Tapestry - User mailing list archive at Nabble.com. --------------------------------------------------------------------- To unsubscribe, e-mail: users-unsubscr...@tapestry.apache.org For additional commands, e-mail: users-h...@tapestry.apache.org