nunit-dev team mailing list archive

[Olof Bjarnason <olof.bjarnason@xxxxxxxxx>]

2009/8/17 Charlie Poole <charlie@xxxxxxxxx>:
> Hi Olof,
>
>> Sound OK to me, although I find the separation of "design"
>> and "implementation" somewhat strange.. To me they are the same thing.
>
> Maybe the words are wrong.
>
>> Here's an attempt..
>>
>> Summary
>> Rationale
>> Usage examples
>
> User stories?

Wording is so hard! :)

I meant what you seem to be meaning with "Design" - the public API.

Even more to the point: I meant examples of the usage of the proposed
new feature, as in how it would look to the end user, in code.

>
>> Design suggestions
>
> If this is a specification, then suggestions doesn't seem to make
> much sense. Maybe you are thinking that the design may be implemented
> by somebody other than the author of the blueprint, and you don't
> want to lock them down too much. In that case, I would say only
> put in what needs to be specified and leave out everything else.

Yes suggestions was meant as "hints on implementation". But I'm not
quite fond of this as it suggests things that ought to be left for
later (after writing the first test!).

>
>> Unresolved issues
>
> This could be a transient heading untill things are actually resolved.
>
> I'm still not sure about implementation - maybe we need it for some
> specs. For example, we may decide to release a feature in stages
> and we would want that as part of an implementation plan. Certainly,
> we don't need a section that tells us how to code it.

I think I like your later suggestion on this thread - wait with
anything "template:ish" and in general, be liberal.

With that said - I wouldn't mind if the "start here templete" would
adhere to the development style of 90% of the NUnit developers (I
guess): TDD. So instead if talking of details, just explain via
examples.

Examples + rationale are the only important stuff I think ..

>
> Charlie
>>
>> >
>> > Andreas
>> >
>> > --
>> > GRATIS für alle GMX-Mitglieder: Die maxdome Movie-FLAT!
>> > Jetzt freischalten unter http://portal.gmx.net/de/go/maxdome01
>> >
>> > _______________________________________________
>> > Mailing list: https://launchpad.net/~nunit-dev Post to     :
>> > nunit-dev@xxxxxxxxxxxxxxxxxxx Unsubscribe :
>> > https://launchpad.net/~nunit-dev More help   :
>> > https://help.launchpad.net/ListHelp
>> >
>>
>>
>>
>> --
>> twitter.com/olofb
>> olofb.wordpress.com
>> olofb.wordpress.com/tag/english
>>
>> _______________________________________________
>> Mailing list: https://launchpad.net/~nunit-dev
>> Post to     : nunit-dev@xxxxxxxxxxxxxxxxxxx
>> Unsubscribe : https://launchpad.net/~nunit-dev
>> More help   : https://help.launchpad.net/ListHelp
>>
>
>
>
>



-- 
twitter.com/olofb
olofb.wordpress.com
olofb.wordpress.com/tag/english