add comments

Author: yaacovCR

src/development.ts

@@ -3,8 +3,13 @@ import type { Constructor } from './jsutils/instanceOf.js';
 import { symbolForGraphQLInstanceOfCheck } from './jsutils/instanceOf.js';
 
 /**
- * A replacement for instanceof which includes an error warning when multi-realm
- * constructors are detected.
+ * An additional check to be included within instanceOf warning when
+ * multi-realm constructors are detected.
+ *
+ * This additional check will be included:
+ * 1. if 'graphql/development.js' is imported explicitly prior to all
+ *    other imports from this library, or
+ * 2. if the "development" condition is set.
  */
 export function developmentInstanceOfCheck(
   value: unknown,

src/jsutils/instanceOf.ts

@@ -2,6 +2,15 @@ export const symbolForGraphQLInstanceOfCheck = Symbol.for(
   'graphql.instanceOfCheck',
 );
 
+/**
+ * "src/development.ts" includes an additional check for development mode
+ * which throws on multiple versions of graphql-js.
+ *
+ * This additional check will be included:
+ * 1. if 'graphql/development.js' is imported explicitly prior to all
+ *    other imports from this library, or
+ * 2. if the "development" condition is set.
+ */
 const check: (_value: unknown, _constructor: Constructor) => void =
   (globalThis as any)[symbolForGraphQLInstanceOfCheck] ??
   ((_value: unknown, _constructor: Constructor) => {