Skip to content

Commit

Permalink
Editorial: Cite API design principles for default true advisement
Browse files Browse the repository at this point in the history
  • Loading branch information
TimothyGu authored and annevk committed Mar 26, 2020
1 parent 8d4e7ca commit 71b8da4
Showing 1 changed file with 2 additions and 1 deletion.
3 changes: 2 additions & 1 deletion index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -2282,6 +2282,7 @@ corresponding argument omitted.
of <emu-val>true</emu-val> for {{boolean}}-typed arguments,
as this can be confusing for authors who might otherwise expect the default
conversion of <emu-val>undefined</emu-val> to be used (i.e., <emu-val>false</emu-val>).
[[API-DESIGN-PRINCIPLES]]
</p>

If the type of an argument is a [=dictionary type=] or a [=union type=] that has
Expand Down Expand Up @@ -4820,7 +4821,7 @@ members' entries might or might not [=map/exist=] in the dictionary value.
encouraged not to use <emu-val>true</emu-val> as the [=dictionary member/default value=] for
{{boolean}}-typed [=dictionary members=], as this can be confusing for authors who might
otherwise expect the default conversion of <emu-val>undefined</emu-val> to be used (i.e.,
<emu-val>false</emu-val>).
<emu-val>false</emu-val>). [[API-DESIGN-PRINCIPLES]]
</p>

An [=ordered map=] with string [=map/keys=] can be implicitly treated as a dictionary value of a
Expand Down

0 comments on commit 71b8da4

Please sign in to comment.