Re: [heycam/webidl] Define definition conventions (#882)

@TimothyGu commented on this pull request.



> +The <dfn>constructor steps</dfn> of a constructor |constructor| should be introduced using text of
+the form “The <code>new |constructor|()</code> constructor steps are:” followed by a list or “The
+<code>new |constructor|()</code> constructor steps are to” followed by an inline description.

Ah, seems like there's a bit more to do.

```suggestion
The <dfn>constructor steps</dfn> of a [=constructor operation=] that is a member of an interface
named |interface| should be introduced using text of
the form “The <code>new |interface|(|args|)</code> constructor steps are:” followed by a list or “The
<code>new |interface|(|args|)</code> constructor steps are to” followed by an inline description,
where |args| is the list of arguments that the [=constructor operation=] takes.
```

Key changes:

- Link “constructor operation”
- Use the name of the interface
- Add the possibility of having arguments

-- 
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/pull/882#pullrequestreview-412050039

Received on Thursday, 14 May 2020 17:55:17 UTC