You're right about the information being technically available, but to newbies it isn't.
I absolutely love the idea of a page that presents a "best of" list of services, with hands-on examples and simple explanations. For me, T5 is all about common patterns. I always use RenderSupport for doing excactly the same thing in all my pages. Why not document something like that in a user friendly way? What I'm trying to say is that information about a small subset of T5 features is sufficient for many users. But the existing docs are VERY generic, covering all aspects at once. If we want world domination for Tapestry5, we need to make stupid users happy :) On Tue, Mar 23, 2010 at 7:42 AM, Igor Drobiazko <igor.drobia...@gmail.com>wrote: > Why is the javadoc insufficient? All the services are located in few > packages depending on the module they were created. Some of them are: > > > http://tapestry.apache.org/tapestry5.1/apidocs/org/apache/tapestry5/ioc/services/package-frame.html > > http://tapestry.apache.org/tapestry5.1/apidocs/org/apache/tapestry5/services/package-frame.html > > http://tapestry.apache.org/tapestry5.1/apidocs/org/apache/tapestry5/hibernate/package-frame.html > > Furthermore there is a page describing all the resources that are > injectable: > > http://tapestry.apache.org/tapestry5.1/tapestry-ioc/injection.html > > You can also open the page ServiceStatus and read its javadoc, if you want > to find an appropriate service: > > http://tapestry.apache.org/tapestry5.1/guide/servicestatus.html > > In summary I would say this issue should be closed as invalid. Tapestry has > over 100 services which are good documented in javadoc. Maybe a wiki > article > which is maintained by the community is a better choice. page. We could > also > provide a new annotation @Injectable which is used to mark the interfaces > that are meant for injection. > > On Tue, Mar 23, 2010 at 12:54 AM, Michael Gentry <mgen...@masslight.net > >wrote: > > > Created: https://issues.apache.org/jira/browse/TAP5-1070 > > > > I'm not sure if what I meant by Injectables makes sense, but basically > > I meant all things supplied by T5 that you can @Inject (such as > > ComponentResources). I had been using T5 for 2-3 months and had no > > idea ComponentResources even existed and then I saw an e-mail to this > > list by Jun Tsai showing it being used to do something that was > > precisely what I needed to solve a particular problem. Great timing, > > but it was also quite lucky. If there was a reference of all things I > > could inject, I might've been able to read through them and have a > > much better idea of things that are available. > > > > Thanks again! > > > > mrg > > > > > > On Mon, Mar 22, 2010 at 3:11 PM, Thiago H. de Paula Figueiredo > > <thiag...@gmail.com> wrote: > > > On Mon, 22 Mar 2010 16:48:31 -0300, Michael Gentry < > > mgen...@masslight.net> > > > wrote: > > > > > >> Hello everyone, > > > > > > Hi! > > > > > > For annotations, > > > > > >> All I'm imagining here is a table for each that lists all of the > > >> annotations and injectables that ship with Tapestry, a short > > >> description as to what they do, and perhaps links to examples/detailed > > >> explanations of how to use them. Another useful column would be what > > >> version of Tapestry it was introduced. > > > > > > Please post a JIRA about it. Seems a very good suggestion to me. > > > > > > -- > > > Thiago H. de Paula Figueiredo > > > Independent Java, Apache Tapestry 5 and Hibernate consultant, > developer, > > and > > > instructor > > > Owner, software architect and developer, Ars Machina Tecnologia da > > > Informação Ltda. > > > http://www.arsmachina.com.br > > > > > > --------------------------------------------------------------------- > > > To unsubscribe, e-mail: users-unsubscr...@tapestry.apache.org > > > For additional commands, e-mail: users-h...@tapestry.apache.org > > > > > > > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: users-unsubscr...@tapestry.apache.org > > For additional commands, e-mail: users-h...@tapestry.apache.org > > > > > > > -- > Best regards, > > Igor Drobiazko > http://tapestry5.de/blog >
