You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@hivemind.apache.org by James Carman <ja...@carmanconsulting.com> on 2007/01/30 14:13:23 UTC

Documentation...

All,

I recently had a discussion with our project team at work about
adopting HiveMind.  One of their biggest gripes was about our
documentation and examples or the lack thereof.  I'd like to see if we
can get some real-world examples out there that show the real power of
HiveMind and how simple it can make your life.  I've got some cool
Hibernate stuff that impresses people when they see it in action.
Since this stuff is based upon non-ASF licensed code, we'll have to
host it somewhere else (it's currently at JavaForge), but we can
always link to it from our site.  Thoughts?  We should definitely try
to HiveMind2.0ize it.

James

Re: Documentation...

Posted by Paul Cooley <pe...@gmail.com>.
Tutorials in confluence are a great way to go.  I definitely vote for that.

On 1/30/07, Achim Hügen <ac...@gmx.de> wrote:
>
> Btw: Apache projects can use a confluence wiki now for documentation
> purposes.
> The confluence support is not official yet but I requested a space and
> it's
> online already: http://cwiki.apache.org/HIVEMIND2/
> The wiki pages get published to a static site periodically.
>
> IMHO the current way of documenting the different modules (core, lib,
> xml, jmx, annotations)
> leads to a very scattered documentation that lacks coherence and is
> updated seldom.
> I would suggest to reduce the documentation located inside the development
> environment: HiveDoc, JavaDoc should be generated and published
> automatically
> to the hivemind site, but all kind of tutorials, cookbooks, examples
> etc. should be edited in the wiki.
>
> Some projects practice that approach already and the results are quite
> impressive:
>
> http://cwiki.apache.org/OPENEJB/
> http://cwiki.apache.org/WICKET/
>
> What's your opinion?
>
> Achim
>
>
> James Carman schrieb:
> > That's what I mean.  If you want an example of how to use Spring with
> > Hibernate, you can find that very quickly.  Not so with HiveMind.
> > That's the kind of stuff we need.  I thought about writing a HiveMind
> > Cookbook and having it published.
> >
> >
> > On 1/30/07, Paul Cooley <pe...@gmail.com> wrote:
> >> Just out of curiousity, what kind of real-world examples did your team
> >> expect/need to see?  Perhaps examples that demonstrate the different
> >> service
> >> models (threaded, pooled, singleton, etc) as well as how to use the
> >> common
> >> framework services (BeanFactory, ChainBuilder, PipelineFactory, etc)
> >> would
> >> be very beneficial in addition to demonstrating how to use Hivemind in
> >> conjunction with common stacks (Torque, Hibernate, etc).
> >>
> >>
> >> On 1/30/07, James Carman <ja...@carmanconsulting.com> wrote:
> >> > All,
> >> >
> >> > I recently had a discussion with our project team at work about
> >> > adopting HiveMind.  One of their biggest gripes was about our
> >> > documentation and examples or the lack thereof.  I'd like to see if
> we
> >> > can get some real-world examples out there that show the real power
> of
> >> > HiveMind and how simple it can make your life.  I've got some cool
> >> > Hibernate stuff that impresses people when they see it in action.
> >> > Since this stuff is based upon non-ASF licensed code, we'll have to
> >> > host it somewhere else (it's currently at JavaForge), but we can
> >> > always link to it from our site.  Thoughts?  We should definitely try
> >> > to HiveMind2.0ize it.
> >> >
> >> > James
> >> >
> >>
> >>
> >>
> >> --
> >> Gotta find my destiny, before it gets too late.-- Ian Curtis
> >
>
>


-- 
Gotta find my destiny, before it gets too late.-- Ian Curtis

Re: Documentation...

Posted by Johan Lindquist <jo...@kawoo.co.uk>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Looks good - definitely the best of both worlds it looks like...

+1 for the Wiki option then ;)

Cheers,

Johan

David Blevins wrote:
> 
> On Jan 30, 2007, at 8:24 AM, Johan Lindquist wrote:
> 
> A Wiki would probably be a better location for the docs for sure, but
> the examples may be better off in the source tree to avoid typos that
> prevent compilation etc.  Also, by having it in source, you help the
> user (re-)package the example should he want to try something on his own.
> 
>> For the OpenEJB, we keep our samples in svn also.  We've recently taken
>> up using the Confluence snippet plugin to create sort of hybrid wiki/svn
>> documentation.  Here is an example example document :)
> 
>>   http://cwiki.apache.org/OPENEJB/embedded-and-remotable.html
> 
>> Here's the wiki source for that doc:
> 
>>   http://cwiki.apache.org/confluence/pages/viewpagesrc.action?pageId=33261
> 
>> And here's some of the svn source for the doc:
> 
> 
>> http://svn.apache.org/repos/asf/incubator/openejb/trunk/openejb3/examples/telephone-stateful/README.txt
> 
> 
>> http://svn.apache.org/repos/asf/incubator/openejb/trunk/openejb3/examples/telephone-stateful/src/test/java/org/apache/openejb/examples/telephone/TelephoneTest.java
> 
> 
>> Notice the "//START SNIPPET" "//END SNIPPET" comments in that second svn
>> link.
> 
>> I'm not sure yet if this approach is the best possible confluence/svn
>> combination, but it seems to be working out so far.  I don't like the
>> "//START SNIPPET" comments in the source, but I can't argue with the
>> results.
> 
> 
>> -David
> 
> 
> Johan
> 
> Achim Hügen wrote:
>>>> Btw: Apache projects can use a confluence wiki now for documentation
>>>> purposes.
>>>> The confluence support is not official yet but I requested a space
>>>> and it's
>>>> online already: http://cwiki.apache.org/HIVEMIND2/
>>>> The wiki pages get published to a static site periodically.
>>>>
>>>> IMHO the current way of documenting the different modules (core, lib,
>>>> xml, jmx, annotations)
>>>> leads to a very scattered documentation that lacks coherence and is
>>>> updated seldom.
>>>> I would suggest to reduce the documentation located inside the
>>>> development
>>>> environment: HiveDoc, JavaDoc should be generated and published
>>>> automatically
>>>> to the hivemind site, but all kind of tutorials, cookbooks, examples
>>>> etc. should be edited in the wiki.
>>>>
>>>> Some projects practice that approach already and the results are quite
>>>> impressive:
>>>>
>>>> http://cwiki.apache.org/OPENEJB/
>>>> http://cwiki.apache.org/WICKET/
>>>>
>>>> What's your opinion?
>>>>
>>>> Achim
>>>>
>>>>
>>>> James Carman schrieb:
>>>>> That's what I mean.  If you want an example of how to use Spring with
>>>>> Hibernate, you can find that very quickly.  Not so with HiveMind.
>>>>> That's the kind of stuff we need.  I thought about writing a HiveMind
>>>>> Cookbook and having it published.
>>>>>
>>>>>
>>>>> On 1/30/07, Paul Cooley <pe...@gmail.com> wrote:
>>>>>> Just out of curiousity, what kind of real-world examples did your team
>>>>>> expect/need to see?  Perhaps examples that demonstrate the different
>>>>>> service
>>>>>> models (threaded, pooled, singleton, etc) as well as how to use the
>>>>>> common
>>>>>> framework services (BeanFactory, ChainBuilder, PipelineFactory, etc)
>>>>>> would
>>>>>> be very beneficial in addition to demonstrating how to use Hivemind in
>>>>>> conjunction with common stacks (Torque, Hibernate, etc).
>>>>>>
>>>>>>
>>>>>> On 1/30/07, James Carman <ja...@carmanconsulting.com> wrote:
>>>>>>> All,
>>>>>>>
>>>>>>> I recently had a discussion with our project team at work about
>>>>>>> adopting HiveMind.  One of their biggest gripes was about our
>>>>>>> documentation and examples or the lack thereof.  I'd like to see
>>>>>>> if we
>>>>>>> can get some real-world examples out there that show the real
>>>>>>> power of
>>>>>>> HiveMind and how simple it can make your life.  I've got some cool
>>>>>>> Hibernate stuff that impresses people when they see it in action.
>>>>>>> Since this stuff is based upon non-ASF licensed code, we'll have to
>>>>>>> host it somewhere else (it's currently at JavaForge), but we can
>>>>>>> always link to it from our site.  Thoughts?  We should definitely try
>>>>>>> to HiveMind2.0ize it.
>>>>>>>
>>>>>>> James
>>>>>>>
>>>>>>
>>>>>>
>>>>>>
>>>>>> --Gotta find my destiny, before it gets too late.-- Ian Curtis
>>>>>
>>>>
>>>>
> 
>>

- --
you too?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFFwEu01Tv8wj7aQ34RAmWIAJ9SVApcfRGaeReMwk1sjwDKV9VrjACaAtaZ
0Gui2LgOBAQx7e57g1l+hPg=
=8wrh
-----END PGP SIGNATURE-----

Re: Documentation...

Posted by David Blevins <da...@visi.com>.
On Jan 30, 2007, at 8:24 AM, Johan Lindquist wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> A Wiki would probably be a better location for the docs for sure, but
> the examples may be better off in the source tree to avoid typos that
> prevent compilation etc.  Also, by having it in source, you help the
> user (re-)package the example should he want to try something on  
> his own.

For the OpenEJB, we keep our samples in svn also.  We've recently  
taken up using the Confluence snippet plugin to create sort of hybrid  
wiki/svn documentation.  Here is an example example document :)

   http://cwiki.apache.org/OPENEJB/embedded-and-remotable.html

Here's the wiki source for that doc:

   http://cwiki.apache.org/confluence/pages/viewpagesrc.action? 
pageId=33261

And here's some of the svn source for the doc:

   http://svn.apache.org/repos/asf/incubator/openejb/trunk/openejb3/ 
examples/telephone-stateful/README.txt
   http://svn.apache.org/repos/asf/incubator/openejb/trunk/openejb3/ 
examples/telephone-stateful/src/test/java/org/apache/openejb/examples/ 
telephone/TelephoneTest.java

Notice the "//START SNIPPET" "//END SNIPPET" comments in that second  
svn link.

I'm not sure yet if this approach is the best possible confluence/svn  
combination, but it seems to be working out so far.  I don't like the  
"//START SNIPPET" comments in the source, but I can't argue with the  
results.


-David


> Johan
>
> Achim Hügen wrote:
>> Btw: Apache projects can use a confluence wiki now for documentation
>> purposes.
>> The confluence support is not official yet but I requested a space  
>> and it's
>> online already: http://cwiki.apache.org/HIVEMIND2/
>> The wiki pages get published to a static site periodically.
>>
>> IMHO the current way of documenting the different modules (core, lib,
>> xml, jmx, annotations)
>> leads to a very scattered documentation that lacks coherence and is
>> updated seldom.
>> I would suggest to reduce the documentation located inside the  
>> development
>> environment: HiveDoc, JavaDoc should be generated and published
>> automatically
>> to the hivemind site, but all kind of tutorials, cookbooks, examples
>> etc. should be edited in the wiki.
>>
>> Some projects practice that approach already and the results are  
>> quite
>> impressive:
>>
>> http://cwiki.apache.org/OPENEJB/
>> http://cwiki.apache.org/WICKET/
>>
>> What's your opinion?
>>
>> Achim
>>
>>
>> James Carman schrieb:
>>> That's what I mean.  If you want an example of how to use Spring  
>>> with
>>> Hibernate, you can find that very quickly.  Not so with HiveMind.
>>> That's the kind of stuff we need.  I thought about writing a  
>>> HiveMind
>>> Cookbook and having it published.
>>>
>>>
>>> On 1/30/07, Paul Cooley <pe...@gmail.com> wrote:
>>>> Just out of curiousity, what kind of real-world examples did  
>>>> your team
>>>> expect/need to see?  Perhaps examples that demonstrate the  
>>>> different
>>>> service
>>>> models (threaded, pooled, singleton, etc) as well as how to use the
>>>> common
>>>> framework services (BeanFactory, ChainBuilder, PipelineFactory,  
>>>> etc)
>>>> would
>>>> be very beneficial in addition to demonstrating how to use  
>>>> Hivemind in
>>>> conjunction with common stacks (Torque, Hibernate, etc).
>>>>
>>>>
>>>> On 1/30/07, James Carman <ja...@carmanconsulting.com> wrote:
>>>>> All,
>>>>>
>>>>> I recently had a discussion with our project team at work about
>>>>> adopting HiveMind.  One of their biggest gripes was about our
>>>>> documentation and examples or the lack thereof.  I'd like to  
>>>>> see if we
>>>>> can get some real-world examples out there that show the real  
>>>>> power of
>>>>> HiveMind and how simple it can make your life.  I've got some cool
>>>>> Hibernate stuff that impresses people when they see it in action.
>>>>> Since this stuff is based upon non-ASF licensed code, we'll  
>>>>> have to
>>>>> host it somewhere else (it's currently at JavaForge), but we can
>>>>> always link to it from our site.  Thoughts?  We should  
>>>>> definitely try
>>>>> to HiveMind2.0ize it.
>>>>>
>>>>> James
>>>>>
>>>>
>>>>
>>>>
>>>> -- 
>>>> Gotta find my destiny, before it gets too late.-- Ian Curtis
>>>
>>
>>
>
> - --
> you too?
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.6 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iD8DBQFFv3Er1Tv8wj7aQ34RAuARAKCNlhvJN10nIqfudA2cXVdoenX+0wCdEBo/
> 1WGxlDGm+35cIvgiF4Rcoi0=
> =xevo
> -----END PGP SIGNATURE-----
>

Re: Documentation...

Posted by Johan Lindquist <jo...@kawoo.co.uk>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

A Wiki would probably be a better location for the docs for sure, but
the examples may be better off in the source tree to avoid typos that
prevent compilation etc.  Also, by having it in source, you help the
user (re-)package the example should he want to try something on his own.

Johan

Achim Hügen wrote:
> Btw: Apache projects can use a confluence wiki now for documentation
> purposes.
> The confluence support is not official yet but I requested a space and it's
> online already: http://cwiki.apache.org/HIVEMIND2/
> The wiki pages get published to a static site periodically.
> 
> IMHO the current way of documenting the different modules (core, lib,
> xml, jmx, annotations)
> leads to a very scattered documentation that lacks coherence and is
> updated seldom.
> I would suggest to reduce the documentation located inside the development
> environment: HiveDoc, JavaDoc should be generated and published
> automatically
> to the hivemind site, but all kind of tutorials, cookbooks, examples
> etc. should be edited in the wiki.
> 
> Some projects practice that approach already and the results are quite
> impressive:
> 
> http://cwiki.apache.org/OPENEJB/
> http://cwiki.apache.org/WICKET/
> 
> What's your opinion?
> 
> Achim
> 
> 
> James Carman schrieb:
>> That's what I mean.  If you want an example of how to use Spring with
>> Hibernate, you can find that very quickly.  Not so with HiveMind.
>> That's the kind of stuff we need.  I thought about writing a HiveMind
>> Cookbook and having it published.
>>
>>
>> On 1/30/07, Paul Cooley <pe...@gmail.com> wrote:
>>> Just out of curiousity, what kind of real-world examples did your team
>>> expect/need to see?  Perhaps examples that demonstrate the different
>>> service
>>> models (threaded, pooled, singleton, etc) as well as how to use the
>>> common
>>> framework services (BeanFactory, ChainBuilder, PipelineFactory, etc)
>>> would
>>> be very beneficial in addition to demonstrating how to use Hivemind in
>>> conjunction with common stacks (Torque, Hibernate, etc).
>>>
>>>
>>> On 1/30/07, James Carman <ja...@carmanconsulting.com> wrote:
>>> > All,
>>> >
>>> > I recently had a discussion with our project team at work about
>>> > adopting HiveMind.  One of their biggest gripes was about our
>>> > documentation and examples or the lack thereof.  I'd like to see if we
>>> > can get some real-world examples out there that show the real power of
>>> > HiveMind and how simple it can make your life.  I've got some cool
>>> > Hibernate stuff that impresses people when they see it in action.
>>> > Since this stuff is based upon non-ASF licensed code, we'll have to
>>> > host it somewhere else (it's currently at JavaForge), but we can
>>> > always link to it from our site.  Thoughts?  We should definitely try
>>> > to HiveMind2.0ize it.
>>> >
>>> > James
>>> >
>>>
>>>
>>>
>>> -- 
>>> Gotta find my destiny, before it gets too late.-- Ian Curtis
>>
> 
> 

- --
you too?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFFv3Er1Tv8wj7aQ34RAuARAKCNlhvJN10nIqfudA2cXVdoenX+0wCdEBo/
1WGxlDGm+35cIvgiF4Rcoi0=
=xevo
-----END PGP SIGNATURE-----

Re: Documentation...

Posted by Achim Hügen <ac...@gmx.de>.
Btw: Apache projects can use a confluence wiki now for documentation 
purposes.
The confluence support is not official yet but I requested a space and it's
online already: http://cwiki.apache.org/HIVEMIND2/
The wiki pages get published to a static site periodically.

IMHO the current way of documenting the different modules (core, lib, 
xml, jmx, annotations)
leads to a very scattered documentation that lacks coherence and is 
updated seldom.
I would suggest to reduce the documentation located inside the development
environment: HiveDoc, JavaDoc should be generated and published 
automatically
to the hivemind site, but all kind of tutorials, cookbooks, examples 
etc. should be edited in the wiki.

Some projects practice that approach already and the results are quite 
impressive:

http://cwiki.apache.org/OPENEJB/
http://cwiki.apache.org/WICKET/

What's your opinion?

Achim


James Carman schrieb:
> That's what I mean.  If you want an example of how to use Spring with
> Hibernate, you can find that very quickly.  Not so with HiveMind.
> That's the kind of stuff we need.  I thought about writing a HiveMind
> Cookbook and having it published.
>
>
> On 1/30/07, Paul Cooley <pe...@gmail.com> wrote:
>> Just out of curiousity, what kind of real-world examples did your team
>> expect/need to see?  Perhaps examples that demonstrate the different 
>> service
>> models (threaded, pooled, singleton, etc) as well as how to use the 
>> common
>> framework services (BeanFactory, ChainBuilder, PipelineFactory, etc) 
>> would
>> be very beneficial in addition to demonstrating how to use Hivemind in
>> conjunction with common stacks (Torque, Hibernate, etc).
>>
>>
>> On 1/30/07, James Carman <ja...@carmanconsulting.com> wrote:
>> > All,
>> >
>> > I recently had a discussion with our project team at work about
>> > adopting HiveMind.  One of their biggest gripes was about our
>> > documentation and examples or the lack thereof.  I'd like to see if we
>> > can get some real-world examples out there that show the real power of
>> > HiveMind and how simple it can make your life.  I've got some cool
>> > Hibernate stuff that impresses people when they see it in action.
>> > Since this stuff is based upon non-ASF licensed code, we'll have to
>> > host it somewhere else (it's currently at JavaForge), but we can
>> > always link to it from our site.  Thoughts?  We should definitely try
>> > to HiveMind2.0ize it.
>> >
>> > James
>> >
>>
>>
>>
>> -- 
>> Gotta find my destiny, before it gets too late.-- Ian Curtis
>

Re: Documentation...

Posted by James Carman <ja...@carmanconsulting.com>.
I don't really like the way Hivetranse did their Hibernate support.  I
just put a HiveMind "face" on the Spring Hibernate support for what I
did.


On 1/30/07, Johan Lindquist <jo...@kawoo.co.uk> wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> The HiveTranse library already covers Hibernate does it not?
>
> As for other examples - the more obscure features (if I can call them
> that) that you mention [Paul] (ChainBuilder & PipelineFactory) require
> some tinkering to get right and extending the examples code to cover all
> these service options would be a great starting point for most.
>
> If you are looking for volunteers to increase the examples, I can
> probably spare some time ...
>
> Cheers,
>
> Johan
>
> James Carman wrote:
> > That's what I mean.  If you want an example of how to use Spring with
> > Hibernate, you can find that very quickly.  Not so with HiveMind.
> > That's the kind of stuff we need.  I thought about writing a HiveMind
> > Cookbook and having it published.
> >
> >
> > On 1/30/07, Paul Cooley <pe...@gmail.com> wrote:
> >> Just out of curiousity, what kind of real-world examples did your team
> >> expect/need to see?  Perhaps examples that demonstrate the different
> >> service
> >> models (threaded, pooled, singleton, etc) as well as how to use the
> >> common
> >> framework services (BeanFactory, ChainBuilder, PipelineFactory, etc)
> >> would
> >> be very beneficial in addition to demonstrating how to use Hivemind in
> >> conjunction with common stacks (Torque, Hibernate, etc).
> >>
> >>
> >> On 1/30/07, James Carman <ja...@carmanconsulting.com> wrote:
> >> > All,
> >> >
> >> > I recently had a discussion with our project team at work about
> >> > adopting HiveMind.  One of their biggest gripes was about our
> >> > documentation and examples or the lack thereof.  I'd like to see if we
> >> > can get some real-world examples out there that show the real power of
> >> > HiveMind and how simple it can make your life.  I've got some cool
> >> > Hibernate stuff that impresses people when they see it in action.
> >> > Since this stuff is based upon non-ASF licensed code, we'll have to
> >> > host it somewhere else (it's currently at JavaForge), but we can
> >> > always link to it from our site.  Thoughts?  We should definitely try
> >> > to HiveMind2.0ize it.
> >> >
> >> > James
> >> >
> >>
> >>
> >>
> >> --
> >> Gotta find my destiny, before it gets too late.-- Ian Curtis
> >
> >
>
> - --
> you too?
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.6 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iD8DBQFFv07Y1Tv8wj7aQ34RAll5AJ9pDTreV+FpKTt9jPqUEMTnT+tg0ACePzgI
> BmIef/zkFJadB9OZh2MS8+I=
> =rs6u
> -----END PGP SIGNATURE-----
>
>

Re: Documentation...

Posted by Johan Lindquist <jo...@kawoo.co.uk>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

If we create new examples, we should be able to add them directly in
Hivemind - I think James is referring to projects which are not licensed
with an Apache license?

Nevertheless, it would be great to build on the existing examples as
people may already have some experience with them.  Also, for some of
them, it would show off the features quite nicely - for example, using
the adder example, add(1.2,2.4) == 4 with the "Rounding"
pipeline/interceptor running ... There is bound to be many more examples
that can use these simple constructs to create a good set of references.

Johan

Paul Cooley wrote:
> I second that.  I'll be more than happy to work up some examples of the
> more advanced features.  Some of them I've not used before, so it would
> be a learning experience for me as well.  :)  As for where we should put
> them, is the licensing issue the only thing holding back placing them
> directly on the hivemind site?  If so, then perhaps all "cookbook" type
> examples should be hosted somewhere that the hive site can link to
> unobtrusively.  I'd suggest we try and make the examples as easy to find
> as possible.
> 
> Cheers.
> 
> On 1/30/07, *Johan Lindquist* <johan@kawoo.co.uk
> <ma...@kawoo.co.uk>> wrote:
> 
> The HiveTranse library already covers Hibernate does it not?
> 
> As for other examples - the more obscure features (if I can call them
> that) that you mention [Paul] (ChainBuilder & PipelineFactory) require
> some tinkering to get right and extending the examples code to cover all
> these service options would be a great starting point for most.
> 
> If you are looking for volunteers to increase the examples, I can
> probably spare some time ...
> 
> Cheers,
> 
> Johan
> 
> James Carman wrote:
>> That's what I mean.  If you want an example of how to use Spring with
>> Hibernate, you can find that very quickly.  Not so with HiveMind.
>> That's the kind of stuff we need.  I thought about writing a HiveMind
>> Cookbook and having it published.
> 
> 
>> On 1/30/07, Paul Cooley <pecooley@gmail.com
> <ma...@gmail.com>> wrote:
>>> Just out of curiousity, what kind of real-world examples did your
> team
>>> expect/need to see?  Perhaps examples that demonstrate the different
>>> service
>>> models (threaded, pooled, singleton, etc) as well as how to use the
>>> common
>>> framework services (BeanFactory, ChainBuilder, PipelineFactory, etc)
>>> would
>>> be very beneficial in addition to demonstrating how to use
> Hivemind in
>>> conjunction with common stacks (Torque, Hibernate, etc).
>>>
>>>
>>> On 1/30/07, James Carman < james@carmanconsulting.com
> <ma...@carmanconsulting.com>> wrote:
>>> > All,
>>> >
>>> > I recently had a discussion with our project team at work about
>>> > adopting HiveMind.  One of their biggest gripes was about our
>>> > documentation and examples or the lack thereof.  I'd like to
> see if we
>>> > can get some real-world examples out there that show the real
> power of
>>> > HiveMind and how simple it can make your life.  I've got some cool
>>> > Hibernate stuff that impresses people when they see it in action.
>>> > Since this stuff is based upon non-ASF licensed code, we'll have to
>>> > host it somewhere else (it's currently at JavaForge), but we can
>>> > always link to it from our site.  Thoughts?  We should
> definitely try
>>> > to HiveMind2.0ize it.
>>> >
>>> > James
>>> >
>>>
>>>
>>>
>>> --
>>> Gotta find my destiny, before it gets too late.-- Ian Curtis
> 
> 
> 

> -- 
> Gotta find my destiny, before it gets too late.-- Ian Curtis

- --
you too?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFFv1sx1Tv8wj7aQ34RAkuGAJ0URf7AEdZ3FmccTW+BYGJU8LFSgwCcDarQ
Vll7K9ik4CKQ3aZmvCyDyZc=
=seHF
-----END PGP SIGNATURE-----

Re: Documentation...

Posted by Paul Cooley <pe...@gmail.com>.
I second that.  I'll be more than happy to work up some examples of the more
advanced features.  Some of them I've not used before, so it would be a
learning experience for me as well.  :)  As for where we should put them, is
the licensing issue the only thing holding back placing them directly on the
hivemind site?  If so, then perhaps all "cookbook" type examples should be
hosted somewhere that the hive site can link to unobtrusively.  I'd suggest
we try and make the examples as easy to find as possible.

Cheers.

On 1/30/07, Johan Lindquist <jo...@kawoo.co.uk> wrote:
>
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> The HiveTranse library already covers Hibernate does it not?
>
> As for other examples - the more obscure features (if I can call them
> that) that you mention [Paul] (ChainBuilder & PipelineFactory) require
> some tinkering to get right and extending the examples code to cover all
> these service options would be a great starting point for most.
>
> If you are looking for volunteers to increase the examples, I can
> probably spare some time ...
>
> Cheers,
>
> Johan
>
> James Carman wrote:
> > That's what I mean.  If you want an example of how to use Spring with
> > Hibernate, you can find that very quickly.  Not so with HiveMind.
> > That's the kind of stuff we need.  I thought about writing a HiveMind
> > Cookbook and having it published.
> >
> >
> > On 1/30/07, Paul Cooley <pe...@gmail.com> wrote:
> >> Just out of curiousity, what kind of real-world examples did your team
> >> expect/need to see?  Perhaps examples that demonstrate the different
> >> service
> >> models (threaded, pooled, singleton, etc) as well as how to use the
> >> common
> >> framework services (BeanFactory, ChainBuilder, PipelineFactory, etc)
> >> would
> >> be very beneficial in addition to demonstrating how to use Hivemind in
> >> conjunction with common stacks (Torque, Hibernate, etc).
> >>
> >>
> >> On 1/30/07, James Carman <ja...@carmanconsulting.com> wrote:
> >> > All,
> >> >
> >> > I recently had a discussion with our project team at work about
> >> > adopting HiveMind.  One of their biggest gripes was about our
> >> > documentation and examples or the lack thereof.  I'd like to see if
> we
> >> > can get some real-world examples out there that show the real power
> of
> >> > HiveMind and how simple it can make your life.  I've got some cool
> >> > Hibernate stuff that impresses people when they see it in action.
> >> > Since this stuff is based upon non-ASF licensed code, we'll have to
> >> > host it somewhere else (it's currently at JavaForge), but we can
> >> > always link to it from our site.  Thoughts?  We should definitely try
> >> > to HiveMind2.0ize it.
> >> >
> >> > James
> >> >
> >>
> >>
> >>
> >> --
> >> Gotta find my destiny, before it gets too late.-- Ian Curtis
> >
> >
>
> - --
> you too?
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.6 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iD8DBQFFv07Y1Tv8wj7aQ34RAll5AJ9pDTreV+FpKTt9jPqUEMTnT+tg0ACePzgI
> BmIef/zkFJadB9OZh2MS8+I=
> =rs6u
> -----END PGP SIGNATURE-----
>



-- 
Gotta find my destiny, before it gets too late.-- Ian Curtis

Re: Documentation...

Posted by Johan Lindquist <jo...@kawoo.co.uk>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

The HiveTranse library already covers Hibernate does it not?

As for other examples - the more obscure features (if I can call them
that) that you mention [Paul] (ChainBuilder & PipelineFactory) require
some tinkering to get right and extending the examples code to cover all
these service options would be a great starting point for most.

If you are looking for volunteers to increase the examples, I can
probably spare some time ...

Cheers,

Johan

James Carman wrote:
> That's what I mean.  If you want an example of how to use Spring with
> Hibernate, you can find that very quickly.  Not so with HiveMind.
> That's the kind of stuff we need.  I thought about writing a HiveMind
> Cookbook and having it published.
> 
> 
> On 1/30/07, Paul Cooley <pe...@gmail.com> wrote:
>> Just out of curiousity, what kind of real-world examples did your team
>> expect/need to see?  Perhaps examples that demonstrate the different
>> service
>> models (threaded, pooled, singleton, etc) as well as how to use the
>> common
>> framework services (BeanFactory, ChainBuilder, PipelineFactory, etc)
>> would
>> be very beneficial in addition to demonstrating how to use Hivemind in
>> conjunction with common stacks (Torque, Hibernate, etc).
>>
>>
>> On 1/30/07, James Carman <ja...@carmanconsulting.com> wrote:
>> > All,
>> >
>> > I recently had a discussion with our project team at work about
>> > adopting HiveMind.  One of their biggest gripes was about our
>> > documentation and examples or the lack thereof.  I'd like to see if we
>> > can get some real-world examples out there that show the real power of
>> > HiveMind and how simple it can make your life.  I've got some cool
>> > Hibernate stuff that impresses people when they see it in action.
>> > Since this stuff is based upon non-ASF licensed code, we'll have to
>> > host it somewhere else (it's currently at JavaForge), but we can
>> > always link to it from our site.  Thoughts?  We should definitely try
>> > to HiveMind2.0ize it.
>> >
>> > James
>> >
>>
>>
>>
>> -- 
>> Gotta find my destiny, before it gets too late.-- Ian Curtis
> 
> 

- --
you too?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFFv07Y1Tv8wj7aQ34RAll5AJ9pDTreV+FpKTt9jPqUEMTnT+tg0ACePzgI
BmIef/zkFJadB9OZh2MS8+I=
=rs6u
-----END PGP SIGNATURE-----

Re: Documentation...

Posted by James Carman <ja...@carmanconsulting.com>.
That's what I mean.  If you want an example of how to use Spring with
Hibernate, you can find that very quickly.  Not so with HiveMind.
That's the kind of stuff we need.  I thought about writing a HiveMind
Cookbook and having it published.


On 1/30/07, Paul Cooley <pe...@gmail.com> wrote:
> Just out of curiousity, what kind of real-world examples did your team
> expect/need to see?  Perhaps examples that demonstrate the different service
> models (threaded, pooled, singleton, etc) as well as how to use the common
> framework services (BeanFactory, ChainBuilder, PipelineFactory, etc) would
> be very beneficial in addition to demonstrating how to use Hivemind in
> conjunction with common stacks (Torque, Hibernate, etc).
>
>
> On 1/30/07, James Carman <ja...@carmanconsulting.com> wrote:
> > All,
> >
> > I recently had a discussion with our project team at work about
> > adopting HiveMind.  One of their biggest gripes was about our
> > documentation and examples or the lack thereof.  I'd like to see if we
> > can get some real-world examples out there that show the real power of
> > HiveMind and how simple it can make your life.  I've got some cool
> > Hibernate stuff that impresses people when they see it in action.
> > Since this stuff is based upon non-ASF licensed code, we'll have to
> > host it somewhere else (it's currently at JavaForge), but we can
> > always link to it from our site.  Thoughts?  We should definitely try
> > to HiveMind2.0ize it.
> >
> > James
> >
>
>
>
> --
> Gotta find my destiny, before it gets too late.-- Ian Curtis

Re: Documentation...

Posted by Paul Cooley <pe...@gmail.com>.
Just out of curiousity, what kind of real-world examples did your team
expect/need to see?  Perhaps examples that demonstrate the different service
models (threaded, pooled, singleton, etc) as well as how to use the common
framework services (BeanFactory, ChainBuilder, PipelineFactory, etc) would
be very beneficial in addition to demonstrating how to use Hivemind in
conjunction with common stacks (Torque, Hibernate, etc).

On 1/30/07, James Carman <ja...@carmanconsulting.com> wrote:
>
> All,
>
> I recently had a discussion with our project team at work about
> adopting HiveMind.  One of their biggest gripes was about our
> documentation and examples or the lack thereof.  I'd like to see if we
> can get some real-world examples out there that show the real power of
> HiveMind and how simple it can make your life.  I've got some cool
> Hibernate stuff that impresses people when they see it in action.
> Since this stuff is based upon non-ASF licensed code, we'll have to
> host it somewhere else (it's currently at JavaForge), but we can
> always link to it from our site.  Thoughts?  We should definitely try
> to HiveMind2.0ize it.
>
> James
>



-- 
Gotta find my destiny, before it gets too late.-- Ian Curtis

Re: Documentation...

Posted by Johan Lindquist <jo...@kawoo.co.uk>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi Jean-Francois - long time ;)

I think the utilities definitely show a "real-world" example, but as you
also say, they may be somewhat on the heavy side ...  But the features
[of HiveMind] used within the project are good candidates still ...

Johan

Jean-Francois Poilpret wrote:
> Hi,
> 
> I think all HiveMind Utilities libraries and their use in HiveBoard
> constitue real-world examples of HiveMind use... 
> Maybe too big examples?
> 
> In more details:
> 
> - HiveLock shows practical examples of user-defined service models
> - HiveRemoting shows practical examples of service factories
> - HiveTranse shows practical examples of service factories and interceptors
> - HiveUtils, HiveEvents show practical examples of services and providers
> based on those services
> - HiveGUI show the same as above, applied to Rich GUI architectures
> 
> - HiveBoard shows how to "put it all together" (HiveMind, HiveTranse,
> HiveUtils, HiveLock, HiveGui, HiveRemoting, HiveEvents!)
> 
> Pretty good start no?
> 
> Cheers
> 
> Jean-Francois
> 
> -----Original Message-----
> From: jwcarman@gmail.com [mailto:jwcarman@gmail.com] On Behalf Of James
> Carman
> Sent: Tuesday, January 30, 2007 8:13 PM
> To: dev@hivemind.apache.org
> Subject: Documentation...
> 
> All,
> 
> I recently had a discussion with our project team at work about
> adopting HiveMind.  One of their biggest gripes was about our
> documentation and examples or the lack thereof.  I'd like to see if we
> can get some real-world examples out there that show the real power of
> HiveMind and how simple it can make your life.  I've got some cool
> Hibernate stuff that impresses people when they see it in action.
> Since this stuff is based upon non-ASF licensed code, we'll have to
> host it somewhere else (it's currently at JavaForge), but we can
> always link to it from our site.  Thoughts?  We should definitely try
> to HiveMind2.0ize it.
> 
> James
> 
> 
> 	
> 
> 	
> 		
> ___________________________________________________________________________ 
> Yahoo! Mail réinvente le mail ! Découvrez le nouveau Yahoo! Mail et son interface révolutionnaire.
> http://fr.mail.yahoo.com
> 
> 

- --
you too?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFFv2nl1Tv8wj7aQ34RAjDGAKCBOCSu7Y3KK3dHnqgkTGoN2Gky8wCePaZV
IMY2bAC8xegyqY5aMQSzHVk=
=yZ8G
-----END PGP SIGNATURE-----

RE: Documentation...

Posted by Jean-Francois Poilpret <jf...@yahoo.fr>.
Hi,

I think all HiveMind Utilities libraries and their use in HiveBoard
constitue real-world examples of HiveMind use... 
Maybe too big examples?

In more details:

- HiveLock shows practical examples of user-defined service models
- HiveRemoting shows practical examples of service factories
- HiveTranse shows practical examples of service factories and interceptors
- HiveUtils, HiveEvents show practical examples of services and providers
based on those services
- HiveGUI show the same as above, applied to Rich GUI architectures

- HiveBoard shows how to "put it all together" (HiveMind, HiveTranse,
HiveUtils, HiveLock, HiveGui, HiveRemoting, HiveEvents!)

Pretty good start no?

Cheers

Jean-Francois

-----Original Message-----
From: jwcarman@gmail.com [mailto:jwcarman@gmail.com] On Behalf Of James
Carman
Sent: Tuesday, January 30, 2007 8:13 PM
To: dev@hivemind.apache.org
Subject: Documentation...

All,

I recently had a discussion with our project team at work about
adopting HiveMind.  One of their biggest gripes was about our
documentation and examples or the lack thereof.  I'd like to see if we
can get some real-world examples out there that show the real power of
HiveMind and how simple it can make your life.  I've got some cool
Hibernate stuff that impresses people when they see it in action.
Since this stuff is based upon non-ASF licensed code, we'll have to
host it somewhere else (it's currently at JavaForge), but we can
always link to it from our site.  Thoughts?  We should definitely try
to HiveMind2.0ize it.

James


	

	
		
___________________________________________________________________________ 
Yahoo! Mail r�invente le mail ! D�couvrez le nouveau Yahoo! Mail et son interface r�volutionnaire.
http://fr.mail.yahoo.com