Re: [WebIDL] add text to discourage `[Optional] Interface / [NoInterfaceObject] interface Interface` and encourage `dictionary Dictionary` instead

On 30/08/11 5:06 AM, timeless wrote:
> I recently saw a snippet of Web IDL code that goes like this:
>    function A(Foo foo, [Optional] Bar bar);
>
>    [NoInterfaceObject] interface Bar
>      { ... };
>
> In response to this, I'd like Web IDL to include some text to the effect of:
>
>      You SHOULD use `dictionary Foo` instead of `[NoInterfaceObject]
> interface Foo` if Foo is intended for use as an argument, especially
> an [Optional] argument.

I think [Optional] is not relevant here.  I've made the following change:

http://dev.w3.org/cvsweb/2006/webapi/WebIDL/Overview.html.diff?r1=1.369;r2=1.370;f=h

Please indicate whether this change is satisfactory.

Thanks,

Cameron