Re: [MO-java-users] Where's the documentation ?

[Zart C. <za...@wa...>]

On vendredi, ao=FB 8, 2003, at 10:55 Europe/Paris, st...@m3... =
wrote:

>
> On 8 August, 2003, Zart Colwin wrote:
>> I'm new to Mock-Object and I'm wondering where to found the
>> documentation explaining how to setup and use the mockobjects-0.09
>> library. I'm thinking about a tutorial or a cookbook like the ones =
you
>> can found with JUnit.
>
> first question. Have you read any of the papers listed at:
>
> http://www.mockobjects.com/wiki/MocksObjectsPaper

Yes, I've read them all. I pretty much understand the theory and =20
benefits of Mock-Objects.
Where I'm stuck is when I try to understand the mockobjects-0.09 =20
library itself.

For an example, I'm currently in the process of learning the =20
EasyMock1.0RC library, I have no problem so far, I'm reading their, =20
small but instructive, documentation, following their instructions to =20=

build my first example. Then, when I need to, I consult their fairly =20
well documented JavaDoc to have more info.

Having a step by step cookbook to help me build the first few examples =20=

is much more valuable than just having undocumented samples ready to =20
run. A cookbook is actually teaching me something, while the samples =20
are just a proof that the software is working and leave me completely =20=

stand still if I don't have enough knowledge to begin with.

That leads me directly to the lack of documentation accompanying =20
mockobjects-0.09.
mockobjects-0.09 is a complex library with no less than 160 classes and =20=

20 interfaces.
The com.mockobjects package, which I suspect is the more important =20
package of the lib, contains more than 15 classes, almost none of them =20=

are documented !  How m'I supposed to learn and understand the =20
mechanics of all this ?  How do you think beginners are feeling facing =20=

such an opaque and hermetic library ?

Personally I've switched to EasyMock1.0RC, because I don't have the =20
time nor the willing to decipher the ins and outs of mockobjects-0.09. =20=

And, because I'm the tech-leader, in charge to educate my fellows, =20
everybody here will use EasyMock1.0RC instead of mockobjects-0.09.

If you want peoples to use mockobjects-0.09, and for it to become a =20
standard like JUnit did, just don't place the entry level 36,000 feet =20=

high !

ZC.


>
> S.
>
>
> -------------------------------------------------------
> This SF.Net email sponsored by: Free pre-built ASP.NET sites including
> Data Reports, E-commerce, Portals, and Forums are available now.
> Download today and enter to win an XBOX or Visual Studio .NET.
> http://aspnet.click-url.com/go/psa00100003ave/=20
> direct;at.aspnet_072303_01/01
> _______________________________________________
> Mockobjects-java-users mailing list
> Moc...@li...
> https://lists.sourceforge.net/lists/listinfo/mockobjects-java-users
>