Improve missing fragment data error message to point to @alias docs.

Reviewed By: lynnshaoyu

Differential Revision: D77629049

fbshipit-source-id: acf724710ceb0a1d9d3e0dfd028ca6dc26ede79d

Author: captbaritone

packages/react-relay/relay-hooks/__tests__/FragmentResource-test.js

@@ -712,7 +712,7 @@ describe('FragmentResource', () => {
           componentDisplayName,
         ),
       ).toThrow(
-        "Relay: Expected to receive an object where `...FragmentResourceTest1Fragment` was spread, but the fragment reference was not found`. This is most likely the result of:\n- Forgetting to spread `FragmentResourceTest1Fragment` in `TestComponent`'s parent's fragment.\n- Conditionally fetching `FragmentResourceTest1Fragment` but unconditionally passing a fragment reference prop to `TestComponent`. If the parent fragment only fetches the fragment conditionally - with e.g. `@include`, `@skip`, or inside a `... on SomeType { }` spread  - then the fragment reference will not exist. In this case, pass `null` if the conditions for evaluating the fragment are not met (e.g. if the `@include(if)` value is false.)",
+        `Relay: Expected to receive an object where \`...FragmentResourceTest1Fragment\` was spread, but the fragment reference was not found\`.`,
       );
     });
   });

packages/react-relay/relay-hooks/legacy/FragmentResource.js

@@ -340,14 +340,15 @@ class FragmentResourceImpl {
         'to `%s`. If the parent fragment only fetches the fragment conditionally ' +
         '- with e.g. `@include`, `@skip`, or inside a `... on SomeType { }` ' +
         'spread  - then the fragment reference will not exist. ' +
-        'In this case, pass `null` if the conditions for evaluating the ' +
-        'fragment are not met (e.g. if the `@include(if)` value is false.)',
+        'This issue can generally be fixed by adding `@alias` after `...%s`.\n' +
+        'See https://relay.dev/docs/next/guides/alias-directive/',
       fragmentNode.name,
       fragmentNode.name,
       componentDisplayName,
       fragmentNode.name,
       fragmentKey == null ? 'a fragment reference' : `the \`${fragmentKey}\``,
       componentDisplayName,
+      fragmentNode.name,
     );
 
     let fragmentResult = null;

packages/react-relay/relay-hooks/readFragmentInternal.js

@@ -198,14 +198,15 @@ function readFragmentInternal(
       'to `%s`. If the parent fragment only fetches the fragment conditionally ' +
       '- with e.g. `@include`, `@skip`, or inside a `... on SomeType { }` ' +
       'spread  - then the fragment reference will not exist. ' +
-      'In this case, pass `null` if the conditions for evaluating the ' +
-      'fragment are not met (e.g. if the `@include(if)` value is false.)',
+      'This issue can generally be fixed by adding `@alias` after `...%s`.\n' +
+      'See https://relay.dev/docs/next/guides/alias-directive/',
     fragmentNode.name,
     fragmentNode.name,
     hookDisplayName,
     fragmentNode.name,
     fragmentKey == null ? 'a fragment reference' : `the \`${fragmentKey}\``,
     hookDisplayName,
+    fragmentNode.name,
   );
 
   const state = getFragmentState(environment, fragmentSelector);

packages/react-relay/relay-hooks/useFragmentInternal_CURRENT.js

@@ -400,13 +400,14 @@ hook useFragmentInternal(
       'to `%s`. If the parent fragment only fetches the fragment conditionally ' +
       '- with e.g. `@include`, `@skip`, or inside a `... on SomeType { }` ' +
       'spread  - then the fragment reference will not exist. ' +
-      'In this case, pass `null` if the conditions for evaluating the ' +
-      'fragment are not met (e.g. if the `@include(if)` value is false.)',
+      'This issue can generally be fixed by adding `@alias` after `...%s`.\n' +
+      'See https://relay.dev/docs/next/guides/alias-directive/',
     fragmentNode.name,
     fragmentNode.name,
     hookDisplayName,
     fragmentNode.name,
     hookDisplayName,
+    fragmentNode.name,
   );
 
   const environment = useRelayEnvironment();

packages/react-relay/relay-hooks/useFragmentInternal_EXPERIMENTAL.js

@@ -436,9 +436,9 @@ hook useFragmentInternal_EXPERIMENTAL(
       '- Conditionally fetching `%s` but unconditionally passing %s prop ' +
       'to `%s`. If the parent fragment only fetches the fragment conditionally ' +
       '- with e.g. `@include`, `@skip`, or inside a `... on SomeType { }` ' +
-      'spread  - then the fragment reference will not exist. ' +
-      'In this case, pass `null` if the conditions for evaluating the ' +
-      'fragment are not met (e.g. if the `@include(if)` value is false.)',
+      'spread - then the fragment reference will not exist. ' +
+      'This issue can generally be fixed by adding `@alias` after `...%s`.\n' +
+      'See https://relay.dev/docs/next/guides/alias-directive/',
     fragmentNode.name,
     fragmentNode.name,
     hookDisplayName,