From 51c422ab1d342424cf8a9859d9e8dd4dac3b22ba Mon Sep 17 00:00:00 2001
From: Jacob Smith <3012099+JakobJingleheimer@users.noreply.github.com>
Date: Thu, 21 May 2026 11:17:43 +0200
Subject: [PATCH 1/3] doc: add motivation to problem statement

Added a motivation section to explain the challenges of determining equality in objects.
---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 0840ab0..7444a77 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,10 @@ Reviewers:
 
 Determine whether and/or how A and B deviate from each other—a very common need that is currently solved only for very narrow cases (primitives, and to some extent `JSON.stringify`able data structures). This issue has 2 parts: (deep) equality and details.
 
+### Motivation
+
+Walking an object is difficult and not fun; determining equality is difficult, requiring an enormous amount of specific knowledge that the vast majority of users don’t have. These complexities create significant barriers and risks to users.
+
 ### Equality (currently)
 
 Primitives are mostly trivial: `Object.is` provides the strictest comparison (SameValue), and `===` (IsStrictlyEqual) is only slightly looser, failing to differentiate oppositely-signed zeros and failing to equate NaNs.

From 66a62242e95a139b0a00a4723f94aeb892f46424 Mon Sep 17 00:00:00 2001
From: Jacob Smith <3012099+JakobJingleheimer@users.noreply.github.com>
Date: Thu, 21 May 2026 12:06:22 +0200
Subject: [PATCH 2/3] fixup!: note decision-making facilitation

---
 README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 7444a77..9f482dd 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,8 @@ Determine whether and/or how A and B deviate from each other—a very common nee
 
 ### Motivation
 
+Facilitate making decisions about equality users often don't understand.
+
 Walking an object is difficult and not fun; determining equality is difficult, requiring an enormous amount of specific knowledge that the vast majority of users don’t have. These complexities create significant barriers and risks to users.
 
 ### Equality (currently)

From 63585fb357dbb71703dfe912366dd59e08910e2b Mon Sep 17 00:00:00 2001
From: Jacob Smith <3012099+JakobJingleheimer@users.noreply.github.com>
Date: Thu, 21 May 2026 13:22:08 +0200
Subject: [PATCH 3/3] fixup!: incorp Eemeli's feedback

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 9f482dd..ee3c57d 100644
--- a/README.md
+++ b/README.md
@@ -24,9 +24,9 @@ Determine whether and/or how A and B deviate from each other—a very common nee
 
 ### Motivation
 
-Facilitate making decisions about equality users often don't understand.
+Facilitate making decisions about deep equality that users are often unaware of.
 
-Walking an object is difficult and not fun; determining equality is difficult, requiring an enormous amount of specific knowledge that the vast majority of users don’t have. These complexities create significant barriers and risks to users.
+Walking an object is difficult and not fun; determining equality can be difficult, requiring an enormous amount of specific knowledge that the vast majority of users don’t have. These complexities create significant barriers and risks to users.
 
 ### Equality (currently)