From 6df3b13743c4a34d112689d0cb50e3d418bcf62c Mon Sep 17 00:00:00 2001
From: Oleg Grenrus <oleg.grenrus@iki.fi>
Date: Thu, 9 Jul 2026 18:25:54 +0300
Subject: [PATCH] Add comment about JSONPath accumulated in reverse in Parser

---
 src/Data/Aeson/Types/Internal.hs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Data/Aeson/Types/Internal.hs b/src/Data/Aeson/Types/Internal.hs
index e2668dd7..41df2153 100644
--- a/src/Data/Aeson/Types/Internal.hs
+++ b/src/Data/Aeson/Types/Internal.hs
@@ -277,7 +277,7 @@ type Success a f r = a -> f r
 -- i.e. a parser to which the input has already been applied.
 newtype Parser a = Parser {
       runParser :: forall f r.
-                   JSONPath
+                   JSONPath       -- Note: the path is accumulated in reverse: <?> cons new elements, however `fail` (and other functions) will reverse the path before calling the failure continuation.
                 -> Failure f r
                 -> Success a f r
                 -> f r