Re: [MMUSIC] Coding from examples [was Re: I-D Action:draft-ietf-mmusic-ice-tcp-09.txt]

[Ari Keranen <[e-mail]>]

3.9.2010 20:11, Marc Petit-Huguenin wrote:
> On 09/03/2010 05:33 AM, Simon Perreault wrote:
>> On 2010-09-02 19:32, Dan Wing wrote:
>>> In any event, if we're going to do a big example, how about
>>> a real example in draft-ietf-sipping-nat-scenarios, if it
>>> doesn't have it already?
>>
>> I don't care where it is, but we need one. When you're implementing
>> something, you end up looking longer at examples than at the actual
>> spec. It really is extremely useful.
>
> And, in my opinion, terribly wrong.  I personally would ban all examples from
> RFC, because at best they are exposing only a subset of what the RFC describe
> and at worst there is bugs in it, bugs[1] that you will then find in
> implementations.

I agree with Simon that an example would be really useful, but I think 
also Marc is right that having it wrong is likely worse than not having 
it at all.

Since we have a draft (the nat-scenarions one) that is already 
documenting this kind of things, I'd say that would be a better place 
for the example and we can add an informative reference so that 
implementors know where to look at.

Also, the examples in the nat-scenarios draft should probably be run 
through multiple real implementations and still would need disclaimers 
saying "there are probably errors in the examples, so take a look at the 
errata, etc.", but that's a whole other story..


Cheers,
Ari