From fb9a07d9021abcf7f82ce1f474cdfe46804d4eef Mon Sep 17 00:00:00 2001
From: Mark Gillard <marzer_@hotmail.com>
Date: Thu, 28 Sep 2023 01:01:11 +0300
Subject: [PATCH] Clarify that key comparison is ordinal (closes #966)

---
 toml.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/toml.md b/toml.md
index 08cc9f67..83a542bd 100644
--- 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"
+
+# prénom = "Françoise", using NFD
+"pr\u0065\u0301nom" = "Françoise"
+```
+
 As long as a key hasn't been directly defined, you may still write to it and to
 names within it.