Skip to content

Commit bc4a629

Browse files
committed
Fix misuse of note box markup
This information needs to be emphasized as important, not marked as an aside that many readers can skip. Also fixed some passive voice that's clearer as active voice.
1 parent be31628 commit bc4a629

File tree

1 file changed

+11
-10
lines changed

1 file changed

+11
-10
lines changed

TSPL.docc/LanguageGuide/Enumerations.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -549,16 +549,17 @@ Raw values can be
549549
strings, characters, or any of the integer or floating-point number types.
550550
Each raw value must be unique within its enumeration declaration.
551551

552-
<!-- XXX fix this note box abuse; this is important, not optional -->
553-
554-
> Note: Raw values are *not* the same as associated values.
555-
> Raw values are set to prepopulated values
556-
> when you first define the enumeration in your code,
557-
> like the three ASCII codes above.
558-
> The raw value for a particular enumeration case is always the same.
559-
> Associated values are set when you create a new constant or variable
560-
> based on one of the enumeration's cases,
561-
> and can be different each time you do so.
552+
Although you can use both raw values and associated values
553+
to give an enumeration an additional value,
554+
it's important to understand the difference between them.
555+
You pick the raw value for an enumeration case
556+
when you define that enumeration case in your code,
557+
like the three ASCII codes above.
558+
The raw value for a particular enumeration case is always the same.
559+
In contrast,
560+
you pick associated values when you create a new constant or variable
561+
using one of the enumeration's cases,
562+
and you can pick a different value each time you do so.
562563

563564
### Implicitly Assigned Raw Values
564565

0 commit comments

Comments
 (0)