+1 for going away from lw-container when possible. I think both archetypes and ready to run examples are necessary.
On 7/27/06, Philip Dodds <[EMAIL PROTECTED]> wrote:
I agree that we need to push more examples away from the lw-container approach, I have been thinking that we could do this by continuing to extend the archetypes. P On 7/26/06, Terry Cox <[EMAIL PROTECTED]> wrote: > > I would recommend more worked examples in the documentation and > strictly, the worked examples should be used as QA tests for snapshots > so that the examples are provably in sync with the releases. > > If you look at the forum, nobody could build consistently until a web > page was put up documenting the sequence of build steps to apply. The > same thing is required for the main common issues like JBoss > integration, manual deployment of dependent classes for lw-container > apps, real-world HTTP endpoint configuration etc. > > The examples are useful, but too simple and too focused upon > lw-container approaches so you can't actually get a broad understanding > of the JBI model from looking at the examples and the docs presuppose a > strong background in Web Service concepts and jargon which is not always > the case for Java-centric developers moving into integration. > > I am finding that the best way to illustrate some of these subjects to > my developers is to build animated PowerPoint presentations that show > how events move about within the environment. If we can find a > web-centric way of doing animation easily, I'm happy to contribute > similar docs for the site? > > Terry >
-- Cheers, Guillaume Nodet