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

• From: timeless <timeless@gmail.com>
• Date: Mon, 29 Aug 2011 13:06:52 -0400
• To: public-script-coord@w3.org
• Message-ID: <CAACrNNciwBW3X6BqnaWBtLoLPMpAEZeVeQ-EOrtyYD7tYKzoZw@mail.gmail.com>

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.

Received on Monday, 29 August 2011 17:07:19 UTC