On Thursday 05 December 2002 15:05, [EMAIL PROTECTED] wrote: > We're approaching this on two fronts. The TapestryLite enhancements will > make adoption of Tapestry much easier. Neil's improved Tutorial looks very > good as well. I'll be redoing much of the Developer's Guide (and renaming > it to User's Guide) at some point as well. But as MindBridge has pointed > out ... nobody reads the docs.
Excellent. But I disagree with you when you say that no one reads the docs. Reading the docs (or at least glance trough to them) and looking to the screenshots is the first thing I do when deciding if a software product is worthy of a download :-) It was because of the docs that I've choosen Tapestry over Enhydra-Barracuda and Zope-ZPT(Page Templates)[1]. I will concede however that sometimes the need for instant gratification makes me "jump to code" without reading the docs carefully enough. ... did I just contradict myself?! Can make I a suggestion about the future re-write of the documentation? I find the UML "Interaction Diagrams" informative, but I still fight sometimes over which method should I override. It would be cool to have some annotations side by side with the diagrams that illustrated when to override the methods, something like: AbstractPage - renderPage() -> The developer should override this method when (...) Right now this information is somewhat scattered over the JavaDocs. > > > I truly believe that there are more hidden pearls in the Framework > > that are just waiting for me to find them, if only I had a map. > > I'm sure there are. Yes there are. I recently find out the joys of dynamic form handling... this must be the coolest (as in headache prevention "cool") feature of Tapestry so far. Jorge Chandra [1] - There is a great deal of overlap between Tapestry and Zope Page Templates. Tapestry has OGNL, ZPT has TALES, Tapestry has Borders, Blocks,Shells .. etc, ZPT has Macros. I think that Tapestry could "steal" some of of ZPT ideas. For example, instead of the fake "jwcid" attribute ZPT uses a XML namespace: 1 Book $25.50 The use of XML namespaces (the tal: thingy) allows a great deal of flexibility, and its use on Tapestry could eliminate the need of specification files. As I understand it future Tapestry versions aim to eliminate or at least reduce the dependency of the "specification" file; the study of how the ZOPE folks did ZPT could prove useful. _______________________________________________ No banners. No pop-ups. No kidding. Introducing My Way - http://www.myway.com ------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ Tapestry-developer mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/tapestry-developer
