On 5/29/07, Gert Vanthienen <[EMAIL PROTECTED]> wrote:
L.S.,
After having followed the user mailing list for a while, it seems that
it's quite a steep learning curve to get started with ServiceMix.
I would like to add a tutorial or getting started guide to the website,
just guiding a new user through the existing documentation and trying to
explain some key concepts on the way. Something like...
# starting the container and connect to it using JMX
# installing some components and deploying e.g. the wsdl-first example
[to explain e.g. components, service assembly, service unit]
# building a simple SA, e.g. re-using the 'File binding' page [to
explain about the maven archetypes]
# building e.g. the protocol bridge example to explain about message
exchange patterns, routing, ...
Would this be a worthwhile addition or are there other areas in the
documentation that need work more urgently? Are there any other topics
to include in this guided tour?
Very nice work Gert! I'm excited that someone else is interested to
help develop more docs - yay!
There are certainly a lot of concepts with which you must be familiar
in order to dive in. I had to explain this to a friend recently and he
was quite overwhelmed at first.
I have had this task in mind for some time and I just haven't had the
time to spend on it yet. I wrote the hello world tutorials on building
components and those are still not 100% complete :-( - if only there
were 30 hours in a day! So, yes, yes - let's create some simple
tutorials to help folks get started!
What I've had in mind is a Getting Started Guide - a set of exercises
to help users become familiar with ServiceMix, including ActiveMQ, in
the most expedient manner possible. I'd like to provide a five minute
version and then much more detailed version, keeping in mind that they
must be from a user's perspective, not a developer of ServiceMix.
The most basic tutorials are the most in demand right now such as,
starting ServiceMix, deploying and testing some of the examples, how
to send test messages using SoapUI and otherwise, walking users
through a step-by-step tutorial of building their own flow using
components that come with ServiceMix.
Before diving right in without a plan, let's at least outline the
exercises we would like to create. That way work on different
exercises can take place concurrently and nobody is hindered by
another exercises level of completion. Below is a suggested list:
1) Starting SMX
2) Explain components (e.g., explain and demo both types from a *user*
perspective)
3) Using JMX with SMX via Jconsole (e.g., poke around a bit)
4) Explain and run SMX examples (e.g., explain how to deploy and how
the flow through SUs works)
5) Developing and testing your own SUs (e.g., this should be broken up
into multiple exercises that build upon one another so that we take
users through a progression that becomes more complex as they go)
This is just a five minute brain dump - let's work on this together
via the wiki.
Bruce
--
perl -e 'print unpack("u30","D0G)[EMAIL
PROTECTED]&5R\"F)R=6-E+G-N>61E<D\!G;6%I;\"YC;VT*"
);'
Apache Geronimo - http://geronimo.apache.org/
Apache ActiveMQ - http://activemq.org/
Apache ServiceMix - http://servicemix.org/
Castor - http://castor.org/
