Re: [heycam/webidl] Pattern for defining constructors, methods, getters, and setters (#730)

Nit: I would remove "when invoked"; it seems redundant.

---

One thing we should include in any recommendations/example names is that you should include variables in the arguments. E.g.

> The <code>Example(<var>arg1</var>, <var>arg2</var>)</code> constructor must run these steps: ...

or similar for methods.

---

It might be nicer if we didn't put the "must" here, and instead said something like "The `Example()` constructor steps are...", leaving the "must" to Web IDL's glue. That would also help solve https://github.com/whatwg/html/issues/3879.

The downside is that this would be a completely novel pattern that no spec seems to use, which is annoying for folks to update to.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/heycam/webidl/issues/730#issuecomment-522344907

Received on Sunday, 18 August 2019 18:38:13 UTC