[Fwd: qpid on structure101.com]

[Alan Conway <al...@gmail.com>]

An old friend of mine at Headway Software has generated some diagrams of 
the qpid java codebase with structure101, see links in forwarded mail. 
Might be interesting for the java developers. I used an older version of 
the product too good effect in a previous life to help untangle 
dependencies when refactoring a large codebase into sensible layers. It 
can help find divergences of the architecture _as defined by the code_ 
from the  architecture as intended by the developers :)

If anyone's interested in further info probably best to mail Paul direct.

Cheers,
Alan.

RE: [Fwd: qpid on structure101.com]

[Paul Hickey <pa...@headwaysoftware.com>]

The architecture diagram on www.structure101.com is indeed auto-generated
direct from the code, so feel free to edit to more accurately reflect the
project view of the architecture. I would be happy to update it on our site,
or if you care to host your own repository, it's pretty easy to set up.

Just let me know.

Cheers,
Paul

> -----Original Message-----
> From: Alan Conway [mailto:aconway@redhat.com]
> Sent: Monday, February 04, 2008 5:11 PM
> To: qpid-dev@incubator.apache.org
> Cc: Paul Hickey
> Subject: Re: [Fwd: qpid on structure101.com]
> 
> Rupert Smith wrote:
> > Hi,
> >
> > Paul Hickey <pa...@headwaysoftware.com>
> >
> > Says that you can mail him to get a free for open source use license for
> > structure 101:
> >
> > Just download from
> > http://www.headwaysoftware.com/downloads/structure101/index.php and
> shoot me
> > over your machine id (structure101/help/about/contact us).
> >
> > The offer is straightforward. He would like us to add an
> acknowledgement,
> > similar to the one we already have for JProfiler, onto the site. If you
> try
> > it and like it, he would be happy to get some appreciative feedback for
> his
> > JOLT nomination, though there is absolutely no obligation for us to do
> so.
> > Also, at some point he might be able to make his repository of OS
> projects
> > that he has run 101 on available for us to upload to:
> >
> > If you wish we can also provide you with the Web App and you can host
> your
> > own repository or if you want to make some suggestions as to the
> snapshots
> > you want on www.structure101.com and/or updated architecture diagrams
> just
> > let me know. Our plan is to give the different projects write access to
> > structure101.com but that ability is not yet there.
> >
> > In particular, I note that the architecture that is on that site is
> probably
> > just one that was generated automatically, in a least-errors-fit way by
> the
> > tool? rather than what makes the most sense to us. The way to read that
> > diagram, is that is is a set of layers, where higher layers may depend
> on
> > lower ones, but not on ones at the same or higher levels. All the arrows
> you
> > see on it, are violations of this rule. Could at the very least, pull
> out
> > something high level that looks more like how we picture Qpid to be,
> that
> > is, common at the bottom, and client/server on top of it, and jms on top
> of
> > client, (tests/examples on top of everything), before adding back in
> some of
> > the detail.
> >
> > I think it is worth a look if you haven't already.
> 
> I've found it useful in the past particularly for spotting bad
> dependencies between layers in the architecture. Often when the
> generated diagrams don't separate out naturally into the layers you
> expect, its because the dependencies in the code aren't really
> structured the way you think they should be.

Re: [Fwd: qpid on structure101.com]

[Alan Conway <ac...@redhat.com>]

Rupert Smith wrote:
> Hi,
> 
> Paul Hickey <pa...@headwaysoftware.com>
> 
> Says that you can mail him to get a free for open source use license for
> structure 101:
> 
> Just download from
> http://www.headwaysoftware.com/downloads/structure101/index.php and shoot me
> over your machine id (structure101/help/about/contact us).
> 
> The offer is straightforward. He would like us to add an acknowledgement,
> similar to the one we already have for JProfiler, onto the site. If you try
> it and like it, he would be happy to get some appreciative feedback for his
> JOLT nomination, though there is absolutely no obligation for us to do so.
> Also, at some point he might be able to make his repository of OS projects
> that he has run 101 on available for us to upload to:
> 
> If you wish we can also provide you with the Web App and you can host your
> own repository or if you want to make some suggestions as to the snapshots
> you want on www.structure101.com and/or updated architecture diagrams just
> let me know. Our plan is to give the different projects write access to
> structure101.com but that ability is not yet there.
> 
> In particular, I note that the architecture that is on that site is probably
> just one that was generated automatically, in a least-errors-fit way by the
> tool? rather than what makes the most sense to us. The way to read that
> diagram, is that is is a set of layers, where higher layers may depend on
> lower ones, but not on ones at the same or higher levels. All the arrows you
> see on it, are violations of this rule. Could at the very least, pull out
> something high level that looks more like how we picture Qpid to be, that
> is, common at the bottom, and client/server on top of it, and jms on top of
> client, (tests/examples on top of everything), before adding back in some of
> the detail.
> 
> I think it is worth a look if you haven't already.

I've found it useful in the past particularly for spotting bad 
dependencies between layers in the architecture. Often when the 
generated diagrams don't separate out naturally into the layers you 
expect, its because the dependencies in the code aren't really 
structured the way you think they should be.

Re: [Fwd: qpid on structure101.com]

[Rupert Smith <ru...@googlemail.com>]

Hi,

Paul Hickey <pa...@headwaysoftware.com>

Says that you can mail him to get a free for open source use license for
structure 101:

Just download from
http://www.headwaysoftware.com/downloads/structure101/index.php and shoot me
over your machine id (structure101/help/about/contact us).

The offer is straightforward. He would like us to add an acknowledgement,
similar to the one we already have for JProfiler, onto the site. If you try
it and like it, he would be happy to get some appreciative feedback for his
JOLT nomination, though there is absolutely no obligation for us to do so.
Also, at some point he might be able to make his repository of OS projects
that he has run 101 on available for us to upload to:

If you wish we can also provide you with the Web App and you can host your
own repository or if you want to make some suggestions as to the snapshots
you want on www.structure101.com and/or updated architecture diagrams just
let me know. Our plan is to give the different projects write access to
structure101.com but that ability is not yet there.

In particular, I note that the architecture that is on that site is probably
just one that was generated automatically, in a least-errors-fit way by the
tool? rather than what makes the most sense to us. The way to read that
diagram, is that is is a set of layers, where higher layers may depend on
lower ones, but not on ones at the same or higher levels. All the arrows you
see on it, are violations of this rule. Could at the very least, pull out
something high level that looks more like how we picture Qpid to be, that
is, common at the bottom, and client/server on top of it, and jms on top of
client, (tests/examples on top of everything), before adding back in some of
the detail.

I think it is worth a look if you haven't already.

Rupert

On 23/01/2008, Alan Conway <al...@gmail.com> wrote:
>
> An old friend of mine at Headway Software has generated some diagrams of
> the qpid java codebase with structure101, see links in forwarded mail.
> Might be interesting for the java developers. I used an older version of
> the product too good effect in a previous life to help untangle
> dependencies when refactoring a large codebase into sensible layers. It
> can help find divergences of the architecture _as defined by the code_
> from the  architecture as intended by the developers :)
>
> If anyone's interested in further info probably best to mail Paul direct.
>
> Cheers,
> Alan.
>
> Hi Alan,
>
> Not sure if you pinged on your qpid java buddies but I thought I would add
> qpid to www.structure101.com. You might point them at the following:
>
> http://www.structure101.com/structure101-java/tracker/qpid/1.0-m2/archw.html
>
>
> http://www.structure101.com/structure101-java/tracker/qpid/1.0-m2/complexity
> .html
>
> And ask them what they think. I would love to have them using
> Structure101.
>
> Cheers,
> Paul
>
>
>
>

Re: [Fwd: qpid on structure101.com]

[Rupert Smith <ru...@googlemail.com>]

This tool is very good. I tried it out on some libraries of stuff that I
wrote, and it is interesting to see how it intuitively picks up on the areas
where I was most confused about choosing the best design (or was too
focussed on the low-level to spend the time sorting out the bigger picture).
The ability to create a layered architectures and export them into
eclipse/intellij, to check against as you code is pretty neat too.

Think they might give us a free license for OS work on Qpid? No harm in
asking...

Rupert

On 23/01/2008, Alan Conway <al...@gmail.com> wrote:
>
> An old friend of mine at Headway Software has generated some diagrams of
> the qpid java codebase with structure101, see links in forwarded mail.
> Might be interesting for the java developers. I used an older version of
> the product too good effect in a previous life to help untangle
> dependencies when refactoring a large codebase into sensible layers. It
> can help find divergences of the architecture _as defined by the code_
> from the  architecture as intended by the developers :)
>
> If anyone's interested in further info probably best to mail Paul direct.
>
> Cheers,
> Alan.
>
> Hi Alan,
>
> Not sure if you pinged on your qpid java buddies but I thought I would add
> qpid to www.structure101.com. You might point them at the following:
>
> http://www.structure101.com/structure101-java/tracker/qpid/1.0-m2/archw.html
>
>
> http://www.structure101.com/structure101-java/tracker/qpid/1.0-m2/complexity
> .html
>
> And ask them what they think. I would love to have them using
> Structure101.
>
> Cheers,
> Paul
>
>
>
>