Add comment

src/config/normalize/lib/star_dot_path/parsing/compare.js

@@ -10,7 +10,15 @@ export const equals = function (queryOrPathA, queryOrPathB) {
   )
 }
 
-// Check if a query is a parent of another
+// Check if a query is a parent of another.
+// The comparison is currently token type-wise, i.e.:
+//  - * does not match other token types
+//  - RegExps does not match prop tokens
+//  - Unions are not resolved
+// Also, this is only for the query without any target, i.e.:
+//  - Negative indices do not match positive indices
+// But this works perfectly when only prop and positive indices are used.
+//  - E.g. on the entries returned by `list()`
 export const parent = function (parentQueryOrPath, childQueryOrPath) {
   const parentPath = parse(parentQueryOrPath)
   const childPath = parse(childQueryOrPath)