Clarify that key comparison is ordinal (closes toml-lang#966)

marzer · Sep 27, 2023 · fb9a07d · fb9a07d
1 parent 23c3fb7
commit fb9a07d
Showing 1 changed file with 13 additions and 0 deletions.
diff --git a/toml.md b/toml.md
@@ -205,6 +205,19 @@ spelling = "favorite"
 "spelling" = "favourite"
 ```
 
+Keys are considered identical if their code point sequences are the same.
+It is possible to create distinct keys that appear visually identical. Doing so is discouraged:
+
+```toml
+# VALID BUT DISCOURAGED
+
+# prénom = "Françoise", using NFC
+"pr\u00e9nom" = "Françoise"
+
+# prénom = "Françoise", using NFD
+"pr\u0065\u0301nom" = "Françoise"
+```
+
 As long as a key hasn't been directly defined, you may still write to it and to
 names within it.