tuscany-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ant elder <ant.el...@gmail.com>
Subject Re: samples again
Date Sun, 12 Sep 2010 08:55:40 GMT
On Thu, Sep 9, 2010 at 10:48 AM, Simon Laws <simonslaws@googlemail.com> wrote:
> On Thu, Sep 9, 2010 at 10:37 AM, kelvin goodson
> <kelvingoodson@apache.org> wrote:
>> I'm taking another look at the samples again, with a view to having a
>> better story for the 2.0 beta release.  Does anyone have any
>> particular thoughts about what we need to do with them?
>>
>> Kelvin.
>>
>
> Firstly, let look to classify the samples so we can understand what they're for.
>
> Helloworld samples (first stop for the new user?)
>   e.g. helloworld
> SCA feature samples (showing specific SCA extensions)
>   e.g. binding-ws, binding-rmi etc + whichever launcher you choose
> Tuscany samples (showing wider Tuscany specific features
>   e.g. distributed OSGi support, or the launcher options used to run
> the SCA feature samples
> Applications samples (working SCA applications
>   e.g. store, store-webapp
>
> These are all fine things but it's not obvious where the user should start.
>
> So my first suggestion would be design the structure of the samples +
> associated README files to make them more accessible.
>
> I started by (re) organizing the pom.xml file a little bit a while ago
> but we should think wider than this.
>

I agree about it being a bit disorganized and that makes it hard to
know where to start, there's so much stuff in the samples folder and
its all doing different types of things. I think i'd like to move all
the helloworld type things into a sub folder so as to separate it out
from the more complex stuff and where appropriate try to build on each
other eg so the binding.ws contribution reuses one of the helloworld
contributions etc. Something like this sort of layout:

samples\GettingStarted
  README.txt gives a step by step guide to using the things below
  contributions/
           - helloworld
           - helloworld-spring
           - helloworld-bpel
           - composites
           - binding.ws
           - binding.jms
           - binding.http
           - etc
    runningTuscany/
           - Basic Java SE
           - WebApp embedded
           - WebApp With Contributions
           - OSGi
           - Shell
           - SCAClient API
           - Domain

   ...ant

Mime
View raw message