docs(core): remove integrated docs (#28228)

- Move the integrated vs. package-based concept page to the deprecated section - Remove the integrated project in package-based repo recipe - Remove the package-based project in integrated repo recipe - Rename standalone to integrated recipe - Update references to integrated or package-based terms in tutorials
nrwl · Oct 2, 2024 · 471536c · 471536c
1 parent 1d10a19
commit 471536c
Show file tree

Hide file tree

Showing 30 changed files with 117 additions and 410 deletions.
diff --git a/docs/README.md b/docs/README.md
@@ -32,7 +32,6 @@ We also have different audiences in mind when writing docs:
 👦 Intermediate User
 
 - They know how to create an Nx repo or add Nx to an existing repo
-- They have heard the terms integrated and package-based
 - They know what a project is and how to make one
 - They understand how to run a task and the basics of caching
 - They can launch the graph

diff --git a/docs/blog/2023-12-28-highlights-2023.md b/docs/blog/2023-12-28-highlights-2023.md
@@ -333,7 +333,7 @@ And obviously, we jumped on the AI train as well. A couple of months ago, we add
 
 ## New Tagline: Smart Monorepos — Fast CI
 
-Nx stands out for its flexibility, accommodating for both monorepo and non-monorepo project structures. This approach allows users to begin with simpler project configurations, leveraging the benefits of Nx’s robust tooling, and later, when the need arises, seamlessly [migrate to a monorepo](/recipes/tips-n-tricks/standalone-to-integrated).
+Nx stands out for its flexibility, accommodating for both monorepo and non-monorepo project structures. This approach allows users to begin with simpler project configurations, leveraging the benefits of Nx’s robust tooling, and later, when the need arises, seamlessly [migrate to a monorepo](/recipes/tips-n-tricks/standalone-to-monorepo).
 
 However, Nx’s true strength becomes most apparent at scale, typically within a monorepo setup. We wanted to capture it in our new tagline: **Smart Monorepos — Fast CI**.
 

diff --git a/docs/generated/manifests/menus.json b/docs/generated/manifests/menus.json
@@ -696,14 +696,6 @@
             "children": [],
             "disableCollapsible": false
           },
-          {
-            "name": "Integrated Repos vs. Package-Based Repos vs. Standalone Apps",
-            "path": "/concepts/integrated-vs-package-based",
-            "id": "integrated-vs-package-based",
-            "isExternal": false,
-            "children": [],
-            "disableCollapsible": false
-          },
           {
             "name": "Nx Daemon",
             "path": "/concepts/nx-daemon",
@@ -909,14 +901,6 @@
         "children": [],
         "disableCollapsible": false
       },
-      {
-        "name": "Integrated Repos vs. Package-Based Repos vs. Standalone Apps",
-        "path": "/concepts/integrated-vs-package-based",
-        "id": "integrated-vs-package-based",
-        "isExternal": false,
-        "children": [],
-        "disableCollapsible": false
-      },
       {
         "name": "Nx Daemon",
         "path": "/concepts/nx-daemon",
@@ -1859,25 +1843,9 @@
             "isExternal": false,
             "children": [
               {
-                "name": "Add a Package-based Project in an Integrated Repo",
-                "path": "/recipes/tips-n-tricks/package-based-in-integrated",
-                "id": "package-based-in-integrated",
-                "isExternal": false,
-                "children": [],
-                "disableCollapsible": false
-              },
-              {
-                "name": "Add an Integrated Project in a Package-based Repo",
-                "path": "/recipes/tips-n-tricks/integrated-in-package-based",
-                "id": "integrated-in-package-based",
-                "isExternal": false,
-                "children": [],
-                "disableCollapsible": false
-              },
-              {
-                "name": "Convert from a Standalone Repository to an Integrated Repository",
-                "path": "/recipes/tips-n-tricks/standalone-to-integrated",
-                "id": "standalone-to-integrated",
+                "name": "Convert from a Standalone Repository to a Monorepo",
+                "path": "/recipes/tips-n-tricks/standalone-to-monorepo",
+                "id": "standalone-to-monorepo",
                 "isExternal": false,
                 "children": [],
                 "disableCollapsible": false
@@ -3441,25 +3409,9 @@
         "isExternal": false,
         "children": [
           {
-            "name": "Add a Package-based Project in an Integrated Repo",
-            "path": "/recipes/tips-n-tricks/package-based-in-integrated",
-            "id": "package-based-in-integrated",
-            "isExternal": false,
-            "children": [],
-            "disableCollapsible": false
-          },
-          {
-            "name": "Add an Integrated Project in a Package-based Repo",
-            "path": "/recipes/tips-n-tricks/integrated-in-package-based",
-            "id": "integrated-in-package-based",
-            "isExternal": false,
-            "children": [],
-            "disableCollapsible": false
-          },
-          {
-            "name": "Convert from a Standalone Repository to an Integrated Repository",
-            "path": "/recipes/tips-n-tricks/standalone-to-integrated",
-            "id": "standalone-to-integrated",
+            "name": "Convert from a Standalone Repository to a Monorepo",
+            "path": "/recipes/tips-n-tricks/standalone-to-monorepo",
+            "id": "standalone-to-monorepo",
             "isExternal": false,
             "children": [],
             "disableCollapsible": false
@@ -3588,25 +3540,9 @@
         "disableCollapsible": false
       },
       {
-        "name": "Add a Package-based Project in an Integrated Repo",
-        "path": "/recipes/tips-n-tricks/package-based-in-integrated",
-        "id": "package-based-in-integrated",
-        "isExternal": false,
-        "children": [],
-        "disableCollapsible": false
-      },
-      {
-        "name": "Add an Integrated Project in a Package-based Repo",
-        "path": "/recipes/tips-n-tricks/integrated-in-package-based",
-        "id": "integrated-in-package-based",
-        "isExternal": false,
-        "children": [],
-        "disableCollapsible": false
-      },
-      {
-        "name": "Convert from a Standalone Repository to an Integrated Repository",
-        "path": "/recipes/tips-n-tricks/standalone-to-integrated",
-        "id": "standalone-to-integrated",
+        "name": "Convert from a Standalone Repository to a Monorepo",
+        "path": "/recipes/tips-n-tricks/standalone-to-monorepo",
+        "id": "standalone-to-monorepo",
         "isExternal": false,
         "children": [],
         "disableCollapsible": false
@@ -4905,6 +4841,14 @@
             "isExternal": false,
             "children": [],
             "disableCollapsible": false
+          },
+          {
+            "name": "Integrated Repos vs. Package-Based Repos vs. Standalone Apps",
+            "path": "/deprecated/integrated-vs-package-based",
+            "id": "integrated-vs-package-based",
+            "isExternal": false,
+            "children": [],
+            "disableCollapsible": false
           }
         ],
         "disableCollapsible": false
@@ -5021,6 +4965,14 @@
         "children": [],
         "disableCollapsible": false
       },
+      {
+        "name": "Integrated Repos vs. Package-Based Repos vs. Standalone Apps",
+        "path": "/deprecated/integrated-vs-package-based",
+        "id": "integrated-vs-package-based",
+        "isExternal": false,
+        "children": [],
+        "disableCollapsible": false
+      },
       {
         "name": "See Also",
         "path": "/see-also",

diff --git a/docs/generated/manifests/nx.json b/docs/generated/manifests/nx.json
@@ -949,17 +949,6 @@
         "path": "/concepts/executors-and-configurations",
         "tags": ["run-tasks"]
       },
-      {
-        "id": "integrated-vs-package-based",
-        "name": "Integrated Repos vs. Package-Based Repos vs. Standalone Apps",
-        "description": "",
-        "mediaImage": "",
-        "file": "shared/concepts/integrated-vs-package-based",
-        "itemList": [],
-        "isExternal": false,
-        "path": "/concepts/integrated-vs-package-based",
-        "tags": ["intro", "repository-types"]
-      },
       {
         "id": "nx-daemon",
         "name": "Nx Daemon",
@@ -1242,17 +1231,6 @@
     "path": "/concepts/executors-and-configurations",
     "tags": ["run-tasks"]
   },
-  "/concepts/integrated-vs-package-based": {
-    "id": "integrated-vs-package-based",
-    "name": "Integrated Repos vs. Package-Based Repos vs. Standalone Apps",
-    "description": "",
-    "mediaImage": "",
-    "file": "shared/concepts/integrated-vs-package-based",
-    "itemList": [],
-    "isExternal": false,
-    "path": "/concepts/integrated-vs-package-based",
-    "tags": ["intro", "repository-types"]
-  },
   "/concepts/nx-daemon": {
     "id": "nx-daemon",
     "name": "Nx Daemon",
@@ -2539,37 +2517,15 @@
         "file": "",
         "itemList": [
           {
-            "id": "package-based-in-integrated",
-            "name": "Add a Package-based Project in an Integrated Repo",
+            "id": "standalone-to-monorepo",
+            "name": "Convert from a Standalone Repository to a Monorepo",
             "description": "",
             "mediaImage": "",
-            "file": "shared/recipes/repo-types/package-based-in-integrated",
+            "file": "shared/recipes/tips-n-tricks/standalone-to-monorepo",
             "itemList": [],
             "isExternal": false,
-            "path": "/recipes/tips-n-tricks/package-based-in-integrated",
-            "tags": ["repository-types"]
-          },
-          {
-            "id": "integrated-in-package-based",
-            "name": "Add an Integrated Project in a Package-based Repo",
-            "description": "",
-            "mediaImage": "",
-            "file": "shared/recipes/repo-types/integrated-in-package-based",
-            "itemList": [],
-            "isExternal": false,
-            "path": "/recipes/tips-n-tricks/integrated-in-package-based",
-            "tags": ["repository-types"]
-          },
-          {
-            "id": "standalone-to-integrated",
-            "name": "Convert from a Standalone Repository to an Integrated Repository",
-            "description": "",
-            "mediaImage": "",
-            "file": "shared/recipes/repo-types/standalone-to-integrated",
-            "itemList": [],
-            "isExternal": false,
-            "path": "/recipes/tips-n-tricks/standalone-to-integrated",
-            "tags": ["repository-types"]
+            "path": "/recipes/tips-n-tricks/standalone-to-monorepo",
+            "tags": []
           },
           {
             "id": "eslint",
@@ -4708,37 +4664,15 @@
     "file": "",
     "itemList": [
       {
-        "id": "package-based-in-integrated",
-        "name": "Add a Package-based Project in an Integrated Repo",
-        "description": "",
-        "mediaImage": "",
-        "file": "shared/recipes/repo-types/package-based-in-integrated",
-        "itemList": [],
-        "isExternal": false,
-        "path": "/recipes/tips-n-tricks/package-based-in-integrated",
-        "tags": ["repository-types"]
-      },
-      {
-        "id": "integrated-in-package-based",
-        "name": "Add an Integrated Project in a Package-based Repo",
+        "id": "standalone-to-monorepo",
+        "name": "Convert from a Standalone Repository to a Monorepo",
         "description": "",
         "mediaImage": "",
-        "file": "shared/recipes/repo-types/integrated-in-package-based",
+        "file": "shared/recipes/tips-n-tricks/standalone-to-monorepo",
         "itemList": [],
         "isExternal": false,
-        "path": "/recipes/tips-n-tricks/integrated-in-package-based",
-        "tags": ["repository-types"]
-      },
-      {
-        "id": "standalone-to-integrated",
-        "name": "Convert from a Standalone Repository to an Integrated Repository",
-        "description": "",
-        "mediaImage": "",
-        "file": "shared/recipes/repo-types/standalone-to-integrated",
-        "itemList": [],
-        "isExternal": false,
-        "path": "/recipes/tips-n-tricks/standalone-to-integrated",
-        "tags": ["repository-types"]
+        "path": "/recipes/tips-n-tricks/standalone-to-monorepo",
+        "tags": []
       },
       {
         "id": "eslint",
@@ -4910,38 +4844,16 @@
     "path": "/recipes/tips-n-tricks",
     "tags": []
   },
-  "/recipes/tips-n-tricks/package-based-in-integrated": {
-    "id": "package-based-in-integrated",
-    "name": "Add a Package-based Project in an Integrated Repo",
+  "/recipes/tips-n-tricks/standalone-to-monorepo": {
+    "id": "standalone-to-monorepo",
+    "name": "Convert from a Standalone Repository to a Monorepo",
     "description": "",
     "mediaImage": "",
-    "file": "shared/recipes/repo-types/package-based-in-integrated",
+    "file": "shared/recipes/tips-n-tricks/standalone-to-monorepo",
     "itemList": [],
     "isExternal": false,
-    "path": "/recipes/tips-n-tricks/package-based-in-integrated",
-    "tags": ["repository-types"]
-  },
-  "/recipes/tips-n-tricks/integrated-in-package-based": {
-    "id": "integrated-in-package-based",
-    "name": "Add an Integrated Project in a Package-based Repo",
-    "description": "",
-    "mediaImage": "",
-    "file": "shared/recipes/repo-types/integrated-in-package-based",
-    "itemList": [],
-    "isExternal": false,
-    "path": "/recipes/tips-n-tricks/integrated-in-package-based",
-    "tags": ["repository-types"]
-  },
-  "/recipes/tips-n-tricks/standalone-to-integrated": {
-    "id": "standalone-to-integrated",
-    "name": "Convert from a Standalone Repository to an Integrated Repository",
-    "description": "",
-    "mediaImage": "",
-    "file": "shared/recipes/repo-types/standalone-to-integrated",
-    "itemList": [],
-    "isExternal": false,
-    "path": "/recipes/tips-n-tricks/standalone-to-integrated",
-    "tags": ["repository-types"]
+    "path": "/recipes/tips-n-tricks/standalone-to-monorepo",
+    "tags": []
   },
   "/recipes/tips-n-tricks/eslint": {
     "id": "eslint",
@@ -6718,6 +6630,17 @@
         "isExternal": false,
         "path": "/deprecated/rescope",
         "tags": []
+      },
+      {
+        "id": "integrated-vs-package-based",
+        "name": "Integrated Repos vs. Package-Based Repos vs. Standalone Apps",
+        "description": "",
+        "mediaImage": "",
+        "file": "shared/deprecated/integrated-vs-package-based",
+        "itemList": [],
+        "isExternal": false,
+        "path": "/deprecated/integrated-vs-package-based",
+        "tags": []
       }
     ],
     "isExternal": false,
@@ -6878,6 +6801,17 @@
     "path": "/deprecated/rescope",
     "tags": []
   },
+  "/deprecated/integrated-vs-package-based": {
+    "id": "integrated-vs-package-based",
+    "name": "Integrated Repos vs. Package-Based Repos vs. Standalone Apps",
+    "description": "",
+    "mediaImage": "",
+    "file": "shared/deprecated/integrated-vs-package-based",
+    "itemList": [],
+    "isExternal": false,
+    "path": "/deprecated/integrated-vs-package-based",
+    "tags": []
+  },
   "/see-also": {
     "id": "see-also",
     "name": "See Also",