doc reference to the source of the algorithm

andimarek · andimarek · commit fdc3be2ebe19 · 2021-08-03T08:01:05.000+10:00
diff --git a/src/main/java/graphql/validation/rules/OverlappingFieldsCanBeMerged.java b/src/main/java/graphql/validation/rules/OverlappingFieldsCanBeMerged.java
@@ -134,6 +134,10 @@ private GraphQLFieldDefinition getVisibleFieldDefinition(GraphQLFieldsContainer
 
 
     private List<Conflict> findConflicts(Map<String, Set<FieldAndType>> fieldMap) {
+        /**
+         * The algorithm implemented here is not the one from the Spec, but is based on
+         * https://tech.xing.com/graphql-overlapping-fields-can-be-merged-fast-ea6e92e0a01
+         */
         List<Conflict> result = new ArrayList<>();
         sameResponseShapeByName(fieldMap, emptyList(), result);
         sameForCommonParentsByName(fieldMap, emptyList(), result);
