Move workspace doc to a common place with integration creation

lnash94 · lnash94 · commit 669e1ea855e9 · 2026-01-06T13:57:46.000+05:30
diff --git a/en/docs/developer-guides/create-a-project.md b/en/docs/developer-guides/create-a-project.md
diff --git a/en/docs/developer-guides/overview.md b/en/docs/developer-guides/overview.md
@@ -0,0 +1,44 @@
+# Overview
+
+Integration in WSO2 Integrator: BI is the foundational space for defining, organizing, and managing integration artifacts such as services, data mappings, and connections. 
+Integrations can contain either a single integration or multiple integrations grouped together as a workspace.
+
+## For single integrations
+
+When building a simple, standalone integration, you can work directly without a workspace. This approach is perfect for:
+
+- Quick, one-off integrations
+- Independent services with no strong dependencies
+- Simple proof-of-concepts
+
+## For complex integrations
+
+Workspaces become essential when you need to:
+
+- Organize related integrations – Group multiple integrations that belong to the same business domain or application
+- Manage dependencies – Allow integrations to reference and use resources from other integrations within the workspace
+- Simplify collaboration – Work on multi-integration projects with a clear organizational structure
+
+### What is a workspace?
+A workspace is a collection of integration packages that can be organized and managed together in a single structure. This allows you to organize multiple related integrations in a single project structure. It provides a centralized environment where you can develop, manage, and maintain interdependent integrations.
+
+???+ Note
+    This feature is available from WSO2 Integrator: BI 1.5.0 onwards and Ballerina version 2201.13.0+.
+
+### Key benefits
+
+- Visual Organization – See all your related integrations in one place with an intuitive tree structure
+- Seamless Navigation – Quickly switch between integrations without leaving your workspace
+- Dependency Management – Integrations within a workspace can reference each other automatically
+- Flexible Structure – Start with standalone integrations and convert them to workspaces as your project grows
+- Reduced Context Switching - Consolidate related repositories (e.g., code + documentation + config) into one view. This minimizes mental load and window management, allowing developers to focus on the logical feature rather than the repository structure.
+- Cross-Project Symbol Resolution - Enable "Go to Definition" and intelligent code navigation across distinct repositories. This removes the need to build or publish local packages to see changes in dependent projects, accelerating the feedback loop.
+- Resource Optimization -  Reduce the memory and CPU overhead of running multiple IDE instances. A single instance managing multiple roots lowers hardware requirements and improves performance on developer workstations.
+
+
+Whether you're building a single integration or orchestrating a complex microservices architecture, WSO2 Integrator: BI provides the flexibility to work in the way that best suits your project's needs.
+
+Follow the below links to learn more about creating , managing workspaces and integrations:
+
+- [Creating an Integration](/developer-guides/workspace-management/create-an-integration)
+- [Managing Integrations in Workspaces](/developer-guides/workspace-management/manage-integrations-in-workspaces/)
diff --git a/en/docs/developer-guides/workspace-management/create-an-integration.md b/en/docs/developer-guides/workspace-management/create-an-integration.md
@@ -38,4 +38,8 @@ Creating an integration within a workspace provides better organization and enab
   <a href="{{base_path}}/assets/img/developer-guides/workspace/expand_workspace.png"><img src="../../../assets/img/developer-guides/workspace/expand_workspace.png" alt="Expand Workspace Details Form" width="80%"></a>
   <a href="{{base_path}}/assets/img/developer-guides/workspace/workspace_details.png"><img src="../../../assets/img/developer-guides/workspace/workspace_details.png" alt="Expand Workspace Details Form" width="80%"></a>
 
-4\. Click **Create Integration** to initialize your integration
+4\. Click **Create Integration** to initialize your integration
+
+Now, you can start creating your integration by developing artifacts. See the [WSO2 Integrator: BI Artifacts]({{base_path}}/developer-guides/wso2-integrator-bi-artifacts/) to learn about the integration artifacts.
+
+Additionally, you can enhance your experience by incorporating AI-powered assistance with [BI Copilot]({{base_path}}/developer-guides/ai-for-integration/build-an-http-service-with-wso2-copilot/).
diff --git a/en/docs/index.md b/en/docs/index.md
@@ -16,11 +16,11 @@
         "title": "Developer Guides",
         "icon": "🛠️ ",
         "links": [
+            {"name": "Create Integrations", "url": "developer-guides/overview"},
             {"name": "Design the Integrations", "url": "developer-guides/design-the-integrations/"},
             {"name": "Data Mapping", "url": "developer-guides/data-mapping/"},
             {"name": "Testing", "url": "developer-guides/test-the-integrations/"},
             {"name": "Debugging & Troubleshooting", "url": "developer-guides/debugging-and-troubleshooting/overview"},
-            {"name": "Workspace Management", "url": "developer-guides/workspace-management/overview"},
             {"name": "Protocols and Connectors", "url": "developer-guides/protocols-and-connectors/overview-of-connectors/"},
             {"name": "Integration Tools", "url": "developer-guides/tools/integration-tools/health-tool/"},
             {"name": "Migration Tools", "url": "developer-guides/tools/migration-tools/mulesoft-migration-tool"},
diff --git a/en/docs/integration-guides/usecases/datamapper/overview.md b/en/docs/integration-guides/usecases/datamapper/overview.md
@@ -42,6 +42,6 @@ Use the Data Mapper when you need to:
 
 - [Data Mapping Quick Start](../../../developer-guides/data-mapping.md)
 - [Design the Integrations](../../../developer-guides/design-the-integrations.md)
-- [Create a Project](../../../developer-guides/create-a-project.md)
+- [Create a Project](../../../developer-guides/overview.md)
 
 ---
diff --git a/en/mkdocs.yml b/en/mkdocs.yml
@@ -106,7 +106,10 @@ nav:
           - Overview: integration-guides/usecases/datamapper/overview.md
           - Read a CSV File and Transform It to an XML File: integration-guides/usecases/datamapper/read-csv-file-and-transform-to-xml-file.md
   - Developer Guides:
-      - Create a Project: developer-guides/create-a-project.md
+      - Create Integrations:
+          Overview: developer-guides/overview.md
+          Create an Integration: developer-guides/workspace-management/create-an-integration.md
+          Manage Workspace: developer-guides/workspace-management/manage-integrations-in-workspaces.md
       - "WSO2 Integrator: BI Artifacts": developer-guides/wso2-integrator-bi-artifacts.md
       - Design the Integrations: developer-guides/design-the-integrations.md
       - Data Mapping: developer-guides/data-mapping.md
@@ -118,10 +121,6 @@ nav:
           Remote Debugging Integrations: developer-guides/debugging-and-troubleshooting/remote-debugging-integrations.md
           Capturing Strand Dumps: developer-guides/debugging-and-troubleshooting/capturing-strand-dumps.md
           Profiling Runtime Performance: developer-guides/debugging-and-troubleshooting/profiling-runtime-performance.md
-      - Workspace Management:
-          Overview: developer-guides/workspace-management/overview.md
-          Create Integration: developer-guides/workspace-management/create-an-integration.md
-          Manage Workspace: developer-guides/workspace-management/manage-integrations-in-workspaces.md
       - AI For Integration:
         - Build an HTTP Service With BI Copilot : developer-guides/ai-for-integration/build-an-http-service-with-wso2-copilot.md
       - Protocols and Connectors:
