Re: [heycam/webidl] #es-to-dictionary and #dictionary-to-es do not have reader-discernable titles (#228)

Right. Planning to add DFNs to each algorithm.

Naming wise, let's do UpperCamelCase so we can then use these as:

```
let |r| be [=ESToDictionary=](|v|).
```

The conversion algorithms which convert ES values to specific IDL types could be named `ESToDictionary(|v|)`, those which convert IDL types to values: `DictionaryToES(|v|)`.

So the IDL Dictionary <-> ES value algorithms would be changed to:

```
<div algorithm>

    An ECMAScript value |V| is [=converted to an IDL value|converted=]
    to an IDL [=dictionary type=] value by
    running the <dfn id="es-to-dictionary" export>ESToDictionary</dfn> algorithm
    (where |D| is the [=dictionary=]):
    […]
</div>
<div algorithm>

    An IDL dictionary value |V| is [=converted to an ECMAScript value|converted=]
    to an ECMAScript <emu-val>Object</emu-val> value by
    running the <dfn id="dictionary-to-es" export>DictionaryToES</dfn> algorithm
    (where |D| is the [=dictionary=]):
    […]
</div>
```

If there's agreement around the plan + naming, I'll go ahead and submit a PR for these.


-- 
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/228#issuecomment-259411043

Received on Wednesday, 9 November 2016 13:11:24 UTC