Update opinion text

Author: compulim

packages/core-graph/src/private/schemas/colorNode.ts

@@ -141,7 +141,7 @@ const SlantNodeWithFixSchema = pipe(
  *       - `@value` could be null, if unwrapped, will be confusing as we removed nulls
  *    - Do not handle full JSON-LD spec: `@context` is an opaque string and its schema is not honored
  *    - Node reference only has `@id` and it should not contain `@type`
- *    - Reduce confusion: node reference must not appear at the root of the flattened graph
+ *    - Reduce confusion: node reference must not appear at the root of the flattened graph, they are semantically empty
  * - Auto-linking for Schema.org: `hasPart` and `isPartOf` are auto-inversed
  * - Keep its root: every node is compliant to JSON-LD, understood by standard parsers
  * - Debuggability: must have at least one `@type`

packages/core-graph/src/private/schemas/flattenNodeObject.spec.ts

@@ -196,30 +196,33 @@ scenario('flattenNodeObject()', bdd => {
     });
 });
 
-scenario('Reduce confusion: node reference must not appear at the root of the flattened graph', bdd => {
-  bdd
-    .given(
-      'a node with @id and @type only',
-      () =>
-        ({
-          '@id': '_:c1',
-          '@type': 'Conversation'
-        }) as const
-    )
-    .when('colored', node => {
-      try {
-        flattenNodeObject(node);
-      } catch (error) {
-        return error;
-      }
-
-      return undefined;
-    })
-    .then('should throw', (_, error) => {
-      expect(() => {
-        if (error) {
-          throw error;
+scenario(
+  'Reduce confusion: node reference must not appear at the root of the flattened graph, they are semantically empty',
+  bdd => {
+    bdd
+      .given(
+        'a node with @id and @type only',
+        () =>
+          ({
+            '@id': '_:c1',
+            '@type': 'Conversation'
+          }) as const
+      )
+      .when('colored', node => {
+        try {
+          flattenNodeObject(node);
+        } catch (error) {
+          return error;
         }
-      }).toThrow('Node reference cannot be flattened');
-    });
-});
+
+        return undefined;
+      })
+      .then('should throw', (_, error) => {
+        expect(() => {
+          if (error) {
+            throw error;
+          }
+        }).toThrow('Node reference cannot be flattened');
+      });
+  }
+);