Update doc links to use relative path

Mirage20 · Mirage20 · commit 4cae9936492f · 2025-08-22T21:15:01.000+05:30
diff --git a/docs/getting-started/deploy-first-component.md b/docs/getting-started/deploy-first-component.md
@@ -10,13 +10,13 @@ This guide walks you through deploying your first component on OpenChoreo. By th
 
 Before you begin, ensure you have:
 
-- ✅ **OpenChoreo installed** in your Kubernetes cluster ([Single Cluster Setup](/docs/getting-started/single-cluster/))
+- ✅ **OpenChoreo installed** in your Kubernetes cluster ([Single Cluster Setup](./single-cluster.md))
 - ✅ **kubectl** configured to access your cluster
 - ✅ **OpenChoreo context** set to your cluster (should be `kind-openchoreo` if following the setup guide)
 
 ## Step 1: Verify Your Setup
 
-First, make sure you have setup choreo on your local cluster following the [guide](/docs/getting-started/single-cluster)
+First, make sure you have setup choreo on your local cluster following the [guide](./single-cluster.md)
 
 You should see all OpenChoreo components running with the control plane and data plane pods in `Running` status.
 
diff --git a/docs/getting-started/single-cluster.md b/docs/getting-started/single-cluster.md
@@ -377,7 +377,7 @@ kubectl get nodes
 After completing this setup you can:
 
 1. **Explore the Backstage portal** (if instal- Direct links to source code and documentationled) at `http://localhost:7007` to get familiar with the developer interface
-2. [Deploy your first component](/docs/getting-started/deploy-first-component) and see it appear automatically in Backstage
+2. [Deploy your first component](./deploy-first-component.md) and see it appear automatically in Backstage
 3. Test the [GCP microservices demo](https://github.com/openchoreo/openchoreo/tree/main/samples/gcp-microservices-demo) to see multi-component applications in action
 4. Deploy additional sample applications from the [OpenChoreo samples](https://github.com/openchoreo/openchoreo/tree/main/samples)
 5. Use Backstage to monitor component health, view logs, and manage your application portfolio
diff --git a/docs/learn-from-examples/examples-catalog.md b/docs/learn-from-examples/examples-catalog.md
@@ -28,7 +28,7 @@ OpenChoreo provides abstractions to define:
 - **BuildPlanes** – Define dedicated Kubernetes clusters for CI/CD operations.
 - **DeploymentPipelines** – Automate application rollouts with promotion workflows.
 
-For more details on these concepts, refer to the [Concepts](/docs/concepts/platform-abstractions) documentation.
+For more details on these concepts, refer to the [Concepts](../concepts/platform-abstractions.md) documentation.
 
 These default configurations provide a quick starting point. Once you have done some exploration you can start creating the necessary artifacts to match the needs of your organization. You can:
 
diff --git a/docs/overview/architecture.md b/docs/overview/architecture.md
@@ -327,7 +327,8 @@ Organizations typically map environments to Data Planes:
 
 ## Next Steps
 
-- **[Concepts](/docs/concepts/developer-abstractions/)** - Learn about Projects, Components, and other abstractions
-- **[Quick Start Guide](/docs/getting-started/quick-start-guide/)** - Try OpenChoreo with a single-cluster development setup
-- **[Installation Guide](/docs/getting-started/single-cluster/)** - Deploy OpenChoreo in your environment
-- **[API Reference](/docs/reference/api/application/project/)** - Detailed documentation of all custom resources
+- **[Concepts](../concepts/developer-abstractions.md)** - Learn about Projects, Components, and other abstractions
+- **[Quick Start Guide](../getting-started/quick-start-guide.md)** - Try OpenChoreo with a single-cluster development
+  setup
+- **[Installation Guide](../getting-started/single-cluster.md)** - Deploy OpenChoreo in your environment
+- **[API Reference](../reference/api/application/project.md)** - Detailed documentation of all custom resources
diff --git a/docs/overview/what-is-openchoreo.md b/docs/overview/what-is-openchoreo.md
@@ -82,10 +82,10 @@ See our [Roadmap](https://github.com/orgs/openchoreo/projects/4) for upcoming fe
 
 Ready to try OpenChoreo? Start here:
 
-1. **[Architecture](/docs/overview/architecture)** - Understand the multi-plane architecture
-2. **[Quick Start Guide](/docs/getting-started/quick-start-guide)** - Try OpenChoreo in minutes using a Dev Container
-3. **[Installation Guide](/docs/getting-started/single-cluster)** - Deploy OpenChoreo in your environment
-4. **[Concepts](/docs/concepts/developer-abstractions)** - Learn the platform abstractions
+1. **[Architecture](./architecture.md)** - Understand the multi-plane architecture
+2. **[Quick Start Guide](../getting-started/quick-start-guide.md)** - Try OpenChoreo in minutes using a Dev Container
+3. **[Installation Guide](../getting-started/single-cluster.md)** - Deploy OpenChoreo in your environment
+4. **[Concepts](../concepts/developer-abstractions.md)** - Learn the platform abstractions
 
 ## Community
 
diff --git a/docs/reference/api/application/build.md b/docs/reference/api/application/build.md
@@ -154,6 +154,6 @@ Builds support the following annotations:
 
 ## Related Resources
 
-- [Component](/docs/reference/api/application/component/) - Components that trigger builds
-- [Workload](/docs/reference/api/application/workload/) - Workloads created by successful builds
-- [BuildPlane](/docs/reference/api/platform/buildplane/) - Infrastructure where builds execute
+- [Component](./component.md) - Components that trigger builds
+- [Workload](./workload.md) - Workloads created by successful builds
+- [BuildPlane](../platform/buildplane.md) - Infrastructure where builds execute
diff --git a/docs/reference/api/application/component.md b/docs/reference/api/application/component.md
@@ -164,9 +164,9 @@ Components support the following annotations:
 
 ## Related Resources
 
-- [Project](/docs/reference/api/application/project/) - Contains components
-- [Build](/docs/reference/api/application/build/) - Build jobs triggered by components
-- [Workload](/docs/reference/api/application/workload/) - Workload definitions associated with components
-- [Service](/docs/reference/api/application/service/) - Service-type component resources
-- [WebApplication](/docs/reference/api/application/webapplication/) - WebApplication-type component resources
-- [ScheduledTask](/docs/reference/api/application/scheduledtask/) - ScheduledTask-type component resources
+- [Project](./project.md) - Contains components
+- [Build](./build.md) - Build jobs triggered by components
+- [Workload](./workload.md) - Workload definitions associated with components
+- [Service](./service.md) - Service-type component resources
+- [WebApplication](./webapplication.md) - WebApplication-type component resources
+- [ScheduledTask](./scheduledtask.md) - ScheduledTask-type component resources
diff --git a/docs/reference/api/application/project.md b/docs/reference/api/application/project.md
@@ -77,6 +77,6 @@ Projects support the following annotations:
 
 ## Related Resources
 
-- [Component](/docs/reference/api/application/component/) - Deployable units within projects
-- [DeploymentPipeline](/docs/reference/api/platform/deployment-pipeline/) - Defines environment promotion paths
-- [Organization](/docs/reference/api/platform/organization/) - Contains projects
+- [Component](./component.md) - Deployable units within projects
+- [DeploymentPipeline](../platform/deployment-pipeline.md) - Defines environment promotion paths
+- [Organization](../platform/organization.md) - Contains projects
diff --git a/docs/reference/api/application/scheduledtask.md b/docs/reference/api/application/scheduledtask.md
@@ -87,7 +87,7 @@ ScheduledTasks support the following annotations:
 
 ## Related Resources
 
-- [Component](/docs/reference/api/application/component/) - Components that own scheduled tasks
-- [Workload](/docs/reference/api/application/workload/) - Workloads referenced by scheduled tasks
-- [ScheduledTaskClass](/docs/reference/api/platform/scheduledtaskclass/) - Platform-defined scheduled task templates
-- [ScheduledTaskBinding](/docs/reference/api/runtime/scheduledtaskbinding/) - Environment-specific scheduled task instances
+- [Component](./component.md) - Components that own scheduled tasks
+- [Workload](./workload.md) - Workloads referenced by scheduled tasks
+- [ScheduledTaskClass](../platform/scheduledtaskclass.md) - Platform-defined scheduled task templates
+- [ScheduledTaskBinding](../runtime/scheduledtaskbinding.md) - Environment-specific scheduled task instances
diff --git a/docs/reference/api/application/service.md b/docs/reference/api/application/service.md
@@ -141,7 +141,7 @@ Services support the following annotations:
 
 ## Related Resources
 
-- [Component](/docs/reference/api/application/component/) - Components that own services
-- [Workload](/docs/reference/api/application/workload/) - Workloads referenced by services
-- [ServiceClass](/docs/reference/api/platform/serviceclass/) - Platform-defined service templates
-- [ServiceBinding](/docs/reference/api/runtime/servicebinding/) - Environment-specific service instances
+- [Component](./component.md) - Components that own services
+- [Workload](./workload.md) - Workloads referenced by services
+- [ServiceClass](../platform/serviceclass.md) - Platform-defined service templates
+- [ServiceBinding](../runtime/servicebinding.md) - Environment-specific service instances
diff --git a/docs/reference/api/application/webapplication.md b/docs/reference/api/application/webapplication.md
@@ -87,7 +87,7 @@ WebApplications support the following annotations:
 
 ## Related Resources
 
-- [Component](/docs/reference/api/application/component/) - Components that own web applications
-- [Workload](/docs/reference/api/application/workload/) - Workloads referenced by web applications
-- [WebApplicationClass](/docs/reference/api/platform/webapplicationclass/) - Platform-defined web application templates
-- [WebApplicationBinding](/docs/reference/api/runtime/webapplicationbinding/) - Environment-specific web application instances
+- [Component](./component.md) - Components that own web applications
+- [Workload](./workload.md) - Workloads referenced by web applications
+- [WebApplicationClass](../platform/webapplicationclass.md) - Platform-defined web application templates
+- [WebApplicationBinding](../runtime/webapplicationbinding.md) - Environment-specific web application instances
diff --git a/docs/reference/api/application/workload.md b/docs/reference/api/application/workload.md
@@ -189,8 +189,8 @@ Workloads support the following annotations:
 
 ## Related Resources
 
-- [Component](/docs/reference/api/application/component/) - Components that own workloads
-- [Service](/docs/reference/api/application/service/) - Service resources that reference workloads
-- [WebApplication](/docs/reference/api/application/webapplication/) - WebApplication resources that reference workloads
-- [ScheduledTask](/docs/reference/api/application/scheduledtask/) - ScheduledTask resources that reference workloads
-- [Build](/docs/reference/api/application/build/) - Build jobs that create workloads
+- [Component](./component.md) - Components that own workloads
+- [Service](./service.md) - Service resources that reference workloads
+- [WebApplication](./webapplication.md) - WebApplication resources that reference workloads
+- [ScheduledTask](./scheduledtask.md) - ScheduledTask resources that reference workloads
+- [Build](./build.md) - Build jobs that create workloads
diff --git a/docs/reference/api/platform/buildplane.md b/docs/reference/api/platform/buildplane.md
@@ -97,6 +97,6 @@ BuildPlanes support the following annotations:
 
 ## Related Resources
 
-- [Build](/docs/reference/api/application/build/) - Build job definitions that execute on BuildPlanes
-- [Component](/docs/reference/api/application/component/) - Application components that trigger builds
-- [Organization](/docs/reference/api/platform/organization/) - Organizational context for BuildPlanes
+- [Build](../application/build.md) - Build job definitions that execute on BuildPlanes
+- [Component](../application/component.md) - Application components that trigger builds
+- [Organization](./organization.md) - Organizational context for BuildPlanes
diff --git a/docs/reference/api/platform/dataplane.md b/docs/reference/api/platform/dataplane.md
@@ -124,6 +124,6 @@ DataPlanes support the following annotations:
 
 ## Related Resources
 
-- [Environment](/docs/reference/api/platform/environment/) - Runtime environments deployed on DataPlanes
-- [Organization](/docs/reference/api/platform/organization/) - Contains DataPlane definitions
-- [Project](/docs/reference/api/application/project/) - Applications deployed to DataPlanes
+- [Environment](./environment.md) - Runtime environments deployed on DataPlanes
+- [Organization](./organization.md) - Contains DataPlane definitions
+- [Project](../application/project.md) - Applications deployed to DataPlanes
diff --git a/docs/reference/api/platform/deployment-pipeline.md b/docs/reference/api/platform/deployment-pipeline.md
@@ -92,7 +92,7 @@ DeploymentPipelines support the following annotations:
 
 ## Related Resources
 
-- [Project](/docs/reference/api/application/project/) - Projects reference deployment pipelines for their promotion
+- [Project](../application/project.md) - Projects reference deployment pipelines for their promotion
   workflows
-- [Environment](/docs/reference/api/platform/environment/) - Environments that are connected through promotion paths
-- [Organization](/docs/reference/api/platform/organization/) - Contains deployment pipeline definitions
+- [Environment](./environment.md) - Environments that are connected through promotion paths
+- [Organization](./organization.md) - Contains deployment pipeline definitions
diff --git a/docs/reference/api/platform/environment.md b/docs/reference/api/platform/environment.md
@@ -105,6 +105,6 @@ Environments support the following annotations:
 
 ## Related Resources
 
-- [DataPlane](/docs/reference/api/platform/dataplane/) - Kubernetes cluster hosting the environment
-- [DeploymentPipeline](/docs/reference/api/platform/deployment-pipeline/) - Defines promotion paths between environments
-- [Organization](/docs/reference/api/platform/organization/) - Contains environment definitions
+- [DataPlane](./dataplane.md) - Kubernetes cluster hosting the environment
+- [DeploymentPipeline](./deployment-pipeline.md) - Defines promotion paths between environments
+- [Organization](./organization.md) - Contains environment definitions
diff --git a/docs/reference/api/platform/organization.md b/docs/reference/api/platform/organization.md
@@ -74,6 +74,6 @@ Organizations support the following annotations:
 
 ## Related Resources
 
-- [Project](/docs/reference/api/application/project/) - Cloud-native applications within an organization
-- [DataPlane](/docs/reference/api/platform/dataplane/) - Kubernetes clusters managed by the organization
-- [Environment](/docs/reference/api/platform/environment/) - Runtime environments for the organization
+- [Project](../application/project.md) - Cloud-native applications within an organization
+- [DataPlane](./dataplane.md) - Kubernetes clusters managed by the organization
+- [Environment](./environment.md) - Runtime environments for the organization
diff --git a/docs/reference/api/platform/scheduledtaskclass.md b/docs/reference/api/platform/scheduledtaskclass.md
@@ -77,8 +77,8 @@ ScheduledTaskClasses support the following annotations:
 
 ## Related Resources
 
-- [ScheduledTask](/docs/reference/api/application/scheduledtask/) - ScheduledTask resources that reference
+- [ScheduledTask](../application/scheduledtask.md) - ScheduledTask resources that reference
   ScheduledTaskClasses
-- [ScheduledTaskBinding](/docs/reference/api/runtime/scheduledtaskbinding/) - Environment-specific scheduled task
+- [ScheduledTaskBinding](../runtime/scheduledtaskbinding.md) - Environment-specific scheduled task
   instances
-- [Organization](/docs/reference/api/platform/organization/) - Contains ScheduledTaskClass definitions
+- [Organization](./organization.md) - Contains ScheduledTaskClass definitions
diff --git a/docs/reference/api/platform/serviceclass.md b/docs/reference/api/platform/serviceclass.md
@@ -80,6 +80,6 @@ ServiceClasses support the following annotations:
 
 ## Related Resources
 
-- [Service](/docs/reference/api/application/service/) - Service resources that reference ServiceClasses
-- [ServiceBinding](/docs/reference/api/runtime/servicebinding/) - Environment-specific service instances
-- [Organization](/docs/reference/api/platform/organization/) - Contains ServiceClass definitions
+- [Service](../application/service.md) - Service resources that reference ServiceClasses
+- [ServiceBinding](../runtime/servicebinding.md) - Environment-specific service instances
+- [Organization](./organization.md) - Contains ServiceClass definitions
diff --git a/docs/reference/api/platform/webapplicationclass.md b/docs/reference/api/platform/webapplicationclass.md
@@ -80,8 +80,8 @@ WebApplicationClasses support the following annotations:
 
 ## Related Resources
 
-- [WebApplication](/docs/reference/api/application/webapplication/) - WebApplication resources that reference
+- [WebApplication](../application/webapplication.md) - WebApplication resources that reference
   WebApplicationClasses
-- [WebApplicationBinding](/docs/reference/api/runtime/webapplicationbinding/) - Environment-specific web application
+- [WebApplicationBinding](../runtime/webapplicationbinding.md) - Environment-specific web application
   instances
-- [Organization](/docs/reference/api/platform/organization/) - Contains WebApplicationClass definitions
+- [Organization](./organization.md) - Contains WebApplicationClass definitions
diff --git a/docs/reference/api/runtime/release.md b/docs/reference/api/runtime/release.md
@@ -156,8 +156,8 @@ Releases support the following annotations:
 
 ## Related Resources
 
-- [ServiceBinding](/docs/reference/api/runtime/servicebinding/) - Creates releases for services
-- [WebApplicationBinding](/docs/reference/api/runtime/webapplicationbinding/) - Creates releases for web applications
-- [ScheduledTaskBinding](/docs/reference/api/runtime/scheduledtaskbinding/) - Creates releases for scheduled tasks
-- [Environment](/docs/reference/api/platform/environment/) - Target environments for releases
-- [DataPlane](/docs/reference/api/platform/dataplane/) - Data planes where resources are deployed
+- [ServiceBinding](./servicebinding.md) - Creates releases for services
+- [WebApplicationBinding](./webapplicationbinding.md) - Creates releases for web applications
+- [ScheduledTaskBinding](./scheduledtaskbinding.md) - Creates releases for scheduled tasks
+- [Environment](../platform/environment.md) - Target environments for releases
+- [DataPlane](../platform/dataplane.md) - Data planes where resources are deployed
diff --git a/docs/reference/api/runtime/scheduledtaskbinding.md b/docs/reference/api/runtime/scheduledtaskbinding.md
@@ -49,11 +49,11 @@ metadata:
 
 The WorkloadTemplateSpec contains the same fields as the Workload spec, allowing environment-specific configuration.
 
-| Field         | Type                                                                                          | Required | Default | Description                                                                                            |
-|---------------|-----------------------------------------------------------------------------------------------|----------|---------|--------------------------------------------------------------------------------------------------------|
-| `containers`  | map[string][Container](/docs/reference/api/application/workload/#container)                   | Yes      | -       | Container specifications keyed by container name. Must have at least one container with the key "main" |
-| `endpoints`   | map[string][WorkloadEndpoint](/docs/reference/api/application/workload/#workloadendpoint)     | No       | {}      | Network endpoints for port exposure keyed by endpoint name                                             |
-| `connections` | map[string][WorkloadConnection](/docs/reference/api/application/workload/#workloadconnection) | No       | {}      | Connections to internal/external resources keyed by connection name                                    |
+| Field         | Type                                                                           | Required | Default | Description                                                                                            |
+|---------------|--------------------------------------------------------------------------------|----------|---------|--------------------------------------------------------------------------------------------------------|
+| `containers`  | map[string][Container](../application/workload.md#container)                   | Yes      | -       | Container specifications keyed by container name. Must have at least one container with the key "main" |
+| `endpoints`   | map[string][WorkloadEndpoint](../application/workload.md#workloadendpoint)     | No       | {}      | Network endpoints for port exposure keyed by endpoint name                                             |
+| `connections` | map[string][WorkloadConnection](../application/workload.md#workloadconnection) | No       | {}      | Connections to internal/external resources keyed by connection name                                    |
 
 ### ReleaseState
 
@@ -101,8 +101,8 @@ ScheduledTaskBindings support the following annotations:
 
 ## Related Resources
 
-- [ScheduledTask](/docs/reference/api/application/scheduledtask/) - ScheduledTask resources that ScheduledTaskBindings
+- [ScheduledTask](../application/scheduledtask.md) - ScheduledTask resources that ScheduledTaskBindings
   deploy
-- [Environment](/docs/reference/api/platform/environment/) - Environments where scheduled tasks are bound
-- [Release](/docs/reference/api/runtime/release/) - Releases created by ScheduledTaskBindings
-- [Workload](/docs/reference/api/application/workload/) - Workload specifications used in bindings
+- [Environment](../platform/environment.md) - Environments where scheduled tasks are bound
+- [Release](./release.md) - Releases created by ScheduledTaskBindings
+- [Workload](../application/workload.md) - Workload specifications used in bindings
diff --git a/docs/reference/api/runtime/servicebinding.md b/docs/reference/api/runtime/servicebinding.md
diff --git a/docs/reference/api/runtime/webapplicationbinding.md b/docs/reference/api/runtime/webapplicationbinding.md
diff --git a/docs/reference/faq.md b/docs/reference/faq.md
