feat(cli): migration guide for lazy loading and custom selection set feature flag (#4934)

* feat(cli): feature flag and migration guide iOS LazyReference ModelPath

* migration guide

* fix code snippets

* fix code snippets

* address PR comments

* update CLI versions

Author: lawmicha

src/components/FeatureFlags/feature-flags.json

@@ -659,6 +659,26 @@
             "defaultExistingProject": true
           }
         ]
+      },
+      "generateModelsForLazyLoadAndCustomSelectionSet": {
+        "description": "Generate models for lazy loading and custom selection set",
+        "type": "Feature",
+        "valueType": "Boolean",
+        "versionAdded": "x.x.x",
+        "values": [
+          {
+            "value": "true",
+            "description": "[Recommended] Add support for lazy loading and custom selection set.",
+            "defaultNewProject": false,
+            "defaultExistingProject": false
+          },
+          {
+            "value": "false",
+            "description": "models will not support selection set customization and lazy loading.",
+            "defaultNewProject": false,
+            "defaultExistingProject": true
+          }
+        ]
       }
     }
   },

src/directory/directory.js

@@ -1947,6 +1947,11 @@ const directory = {
       migration: {
         title: 'Migration & Backwards Compatibility',
         items: [
+          {
+            title: 'Lazy Loading and Custom Selection Set',
+            route: '/cli/migration/lazy-load-custom-selection-set',
+            filters: []
+          },
           {
             title: 'GraphQL Transformer v1 to v2 migration',
             route: '/cli/migration/transformer-migration',

src/pages/cli/graphql/data-modeling.mdx

@@ -316,11 +316,6 @@ mutation CreatePost {
 
 ### Belongs To relationship
 
-<Callout>
-
-Bi-directional "has one" relationships currently cannot be represented on iOS due to Swift language limitations.
-</Callout>
-
 Make a "has one" or "has many" relationship bi-directional with the `@belongsTo` directive.
 
 <BlockSwitcher>