Skip to content

Commit 71b8da4

Browse files
TimothyGuannevk
authored andcommitted
Editorial: Cite API design principles for default true advisement
1 parent 8d4e7ca commit 71b8da4

File tree

1 file changed

+2
-1
lines changed

1 file changed

+2
-1
lines changed

index.bs

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2282,6 +2282,7 @@ corresponding argument omitted.
22822282
of <emu-val>true</emu-val> for {{boolean}}-typed arguments,
22832283
as this can be confusing for authors who might otherwise expect the default
22842284
conversion of <emu-val>undefined</emu-val> to be used (i.e., <emu-val>false</emu-val>).
2285+
[[API-DESIGN-PRINCIPLES]]
22852286
</p>
22862287

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

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

0 commit comments

Comments
 (0)