[EMAIL PROTECTED] wrote: > Please don't get me wrong: I'm not aiming at critisizing the example or > the great work done so far. I'm just and only trying to show where newbies > lack information. As the user feedback request showed, for most users > quality of information is an issue -- and mainly the "why" and "where to > get that info?".
Just as an example what I mean by "where to get that info?": I stumbled in http://goopen.org/confluence/display/SM/Quartz quartz over "A number of properties can be configured on the component: marshaler:..." Briefly, we tell a newbie "hey, there's a property called marshaler you can set" but we do not provide him with the slightest hint on how to set it correctly. Well, from that description I guess "marshaler" will be on the same level as "triggers" (thus inside <bean class="org.apache.servicemix.components.quartz.QuartzComponent"> ) and -- as only one single parameter is needed -- the statement has to be just like it is for <property name="repeatCount" value="20"/> thus I add <property name="marshaler" value="org.apache.servicemix.components.quartz.DefaultQuartzMarshaler" /> which brings the following error (truncated) -------- Loading Apache ServiceMix from file: Timer2WireTap2File_and_Screen.xml INFO - ConnectorServerFactoryBean - JMX connector available at: service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi Caught: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'org.apache.servicemix.jbi.container.ActivationSpec' defined in file [C:\SM_binary30b\bin\Timer2WireTap2File_and_Screen.xml]: Cannot create inner bean 'org.apache.servicemix.components. quartz.QuartzComponent' while setting constructor argument with index 0; ... ... Caused by: java.lang.IllegalArgumentException: No matching editors or conversion strategy found at org.springframework.beans.TypeConverterDelegate.convertIfNecessary(TypeConverterDelegate.java:212) at org.springframework.beans.TypeConverterDelegate.convertIfNecessary(TypeConverterDelegate.java:127) ... ... -------- This message is not really leading towards the correct way. And IMHO it's not THAT proximate/obvious to do this http://google.com/codesearch?q=marshaler+file%3A.xml+package%3Ahttp%3A%2F%2Fsvn.apache.org%2Frepos%2Fasf%2Fincubator%2Fservicemix%2Ftrunk&btnG=Search&hl=en&lr= google search in order to find how other marshalers are configured and to try out <property name="marshaler"> <bean class="org.apache.servicemix.components.quartz.DefaultQuartzMarshaler" /> </property> what finally works. IMHO, a guide on _how to figure out the correct way_ to configure SM and it's components is required, as a) docu will never cover own components etc. (=user HAS TO find out himself) and b) will also never cover 100% for current code, e.g. http://goopen.org/confluence/display/SM30UG/6.+Configuring+ServiceMix configuration does not mention the meaning of several attributes (eg. persistent, notifyStatistics). It teaches newbies some practices (redurcing frustration) and helps us more experienced ones to find more efficient ways for our issue fixing. I myself tried to include some of the methods learned into the wiki pages, but it's a) distributed and b) only the tip of the iceberg. Consequently, one "brainstorming" wiki page is my suggestion. Items may usually consist of 1) error message highlighting relevant pieces of information, 2) conclusions from those pieces, 3) successful way(s) of info retrieval, 4) (maybe) why/when using this way?, see http://goopen.org/confluence/display/SM30UG/3.+Installation#3.Installation-Troubleshooting troubleshooting for a clue. Any thoughts? Any volunteers? I really hope a well helping docu will be installed :-) but I'm quite surprised how difficult it is to do for a software with such a complex infrastructure :-/ Georg -- View this message in context: http://www.nabble.com/out-of-the-box-experience-very-limited-tf2389329.html#a6670310 Sent from the ServiceMix - Dev mailing list archive at Nabble.com.
