From daf261fcdd0849b99fce7b6982b753dfecfd818f Mon Sep 17 00:00:00 2001 From: Rosen Silva Date: Tue, 21 Apr 2026 08:45:17 +0530 Subject: [PATCH] Fix broken links and anchors flagged by docusaurus build Resolves all broken markdown links and broken anchors reported by `npm run build`, so the production build runs clean. Markdown links: - intercom/overview: ../../overview.md -> ../../../overview.md (was resolving to a non-existent connectors/catalog/overview.md) - twilio/4.0.x/overview: setup-guide.md -> ../setup-guide.md (the file lives at the parent twilio/ dir, not in 4.0.x/) - database/mssql/example & database/redis/example: relative paths corrected to reach develop/create-integrations/create-new-integration.md (redis was pointing at a non-existent getting-started/ path) - integration-artifacts/event/azure-service-bus: connector dir is asb/, not azure-service-bus/ - integration-artifacts/file/high-availability: dropped one extra ../ that was escaping out of /docs/ - reference/overview & reference/protocols: data-formats.md -> data-formats/index.md (data-formats is a directory) Anchor: - intercom/action-reference: setup-guide#step-6-... -> step-5-... (heading was renumbered; only step-5 exists) Page link: - get-started/key-concepts: /docs/develop/organize-code/ -> /docs/develop/organize-code/overview (no index page exists) Co-Authored-By: Claude Opus 4.7 (1M context) --- .../catalog/communication/intercom/action-reference.md | 2 +- en/docs/connectors/catalog/communication/intercom/overview.md | 2 +- .../connectors/catalog/communication/twilio/4.0.x/overview.md | 2 +- en/docs/connectors/catalog/database/mssql/example.md | 2 +- en/docs/connectors/catalog/database/redis/example.md | 2 +- .../develop/integration-artifacts/event/azure-service-bus.md | 2 +- en/docs/develop/integration-artifacts/file/high-availability.md | 2 +- en/docs/get-started/key-concepts.md | 2 +- en/docs/reference/overview.md | 2 +- en/docs/reference/protocols.md | 2 +- 10 files changed, 10 insertions(+), 10 deletions(-) diff --git a/en/docs/connectors/catalog/communication/intercom/action-reference.md b/en/docs/connectors/catalog/communication/intercom/action-reference.md index 94b341deb1..883f82174b 100644 --- a/en/docs/connectors/catalog/communication/intercom/action-reference.md +++ b/en/docs/connectors/catalog/communication/intercom/action-reference.md @@ -541,7 +541,7 @@ intercom:Ticket ticket = check intercomClient->/tickets.post({ | Field | Type | Required | Description | |---|---|---|---| -| `ticketTypeId` | `string` | Yes | ID of the ticket type (see [Setup guide](setup-guide.md#step-6-optional-find-your-ticket-type-id)) | +| `ticketTypeId` | `string` | Yes | ID of the ticket type (see [Setup guide](setup-guide.md#step-5-optional-find-your-ticket-type-id)) | | `contacts` | `CreateTicketRequestContacts[]` | Yes | Contacts associated with the ticket | | `companyId` | `string` | No | Company to associate with the ticket | diff --git a/en/docs/connectors/catalog/communication/intercom/overview.md b/en/docs/connectors/catalog/communication/intercom/overview.md index 7d16f677ed..b09679797f 100644 --- a/en/docs/connectors/catalog/communication/intercom/overview.md +++ b/en/docs/connectors/catalog/communication/intercom/overview.md @@ -49,4 +49,4 @@ Check the issue tracker for open issues that interest you. We look forward to re - [Setup guide](setup-guide.md) — Create an Intercom app and obtain your access token - [Action reference](action-reference.md) — Browse all available operations and sample code -- [Connectors overview](../../overview.md) — Explore other available connectors +- [Connectors overview](../../../overview.md) — Explore other available connectors diff --git a/en/docs/connectors/catalog/communication/twilio/4.0.x/overview.md b/en/docs/connectors/catalog/communication/twilio/4.0.x/overview.md index 71a800bca8..f843d9bcee 100644 --- a/en/docs/connectors/catalog/communication/twilio/4.0.x/overview.md +++ b/en/docs/connectors/catalog/communication/twilio/4.0.x/overview.md @@ -31,7 +31,7 @@ See the **[Action Reference](action-reference.md)** for the full list of operati ## Documentation -* **[Setup Guide](setup-guide.md)**: This guide walks you through obtaining the Twilio credentials required to use the Ballerina Twilio connector. +* **[Setup Guide](../setup-guide.md)**: This guide walks you through obtaining the Twilio credentials required to use the Ballerina Twilio connector. * **[Action Reference](action-reference.md)**: Full reference for all clients — operations, parameters, return types, and sample code. diff --git a/en/docs/connectors/catalog/database/mssql/example.md b/en/docs/connectors/catalog/database/mssql/example.md index 803179524f..ea4ed3664f 100644 --- a/en/docs/connectors/catalog/database/mssql/example.md +++ b/en/docs/connectors/catalog/database/mssql/example.md @@ -22,7 +22,7 @@ flowchart LR ## Setting up the MSSQL integration -> **New to WSO2 Integrator?** Follow the [Create a New Integration](../develop/create-integrations/create-new-integration.md) guide to set up your integration first, then return here to add the connector. +> **New to WSO2 Integrator?** Follow the [Create a New Integration](../../../../develop/create-integrations/create-new-integration.md) guide to set up your integration first, then return here to add the connector. ## Adding the MSSQL connector diff --git a/en/docs/connectors/catalog/database/redis/example.md b/en/docs/connectors/catalog/database/redis/example.md index d8f5987598..723b72dd62 100644 --- a/en/docs/connectors/catalog/database/redis/example.md +++ b/en/docs/connectors/catalog/database/redis/example.md @@ -23,7 +23,7 @@ flowchart LR ## Setting up the Redis integration -> **New to WSO2 Integrator?** Follow the [Create a New Integration](../getting-started/create-integration.md) guide to set up your project first, then return here to add the connector. +> **New to WSO2 Integrator?** Follow the [Create a New Integration](../../../../develop/create-integrations/create-new-integration.md) guide to set up your project first, then return here to add the connector. ## Adding the Redis connector diff --git a/en/docs/develop/integration-artifacts/event/azure-service-bus.md b/en/docs/develop/integration-artifacts/event/azure-service-bus.md index 8723b3099b..dd88477890 100644 --- a/en/docs/develop/integration-artifacts/event/azure-service-bus.md +++ b/en/docs/develop/integration-artifacts/event/azure-service-bus.md @@ -211,4 +211,4 @@ The `onMessage` handler receives an `asb:Message` parameter with the message con - [RabbitMQ](rabbitmq.md) — consume messages from RabbitMQ queues - [Kafka](kafka.md) — consume messages from Apache Kafka topics - [Connections](../supporting/connections.md) — reuse Azure Service Bus connection strings across services -- [Azure Service Bus connector reference](../../../connectors/catalog/messaging/azure-service-bus/overview.md) — full connector API reference +- [Azure Service Bus connector reference](../../../connectors/catalog/messaging/asb/overview.md) — full connector API reference diff --git a/en/docs/develop/integration-artifacts/file/high-availability.md b/en/docs/develop/integration-artifacts/file/high-availability.md index b06cb27b36..4b245d6f6f 100644 --- a/en/docs/develop/integration-artifacts/file/high-availability.md +++ b/en/docs/develop/integration-artifacts/file/high-availability.md @@ -185,4 +185,4 @@ If the coordination database is temporarily unavailable: - [FTP / SFTP](ftp-sftp.md) — service configuration, authentication, and file handlers - [Resiliency](resiliency.md) — automatic retry and circuit breaker for FTP client operations -- [Scaling and high availability](../../../../deploy-operate/deploy/scaling-ha.md) — deployment-level scaling and HA strategies +- [Scaling and high availability](../../../deploy-operate/deploy/scaling-ha.md) — deployment-level scaling and HA strategies diff --git a/en/docs/get-started/key-concepts.md b/en/docs/get-started/key-concepts.md index 0d94cc4a21..d0d9c14b1f 100644 --- a/en/docs/get-started/key-concepts.md +++ b/en/docs/get-started/key-concepts.md @@ -18,7 +18,7 @@ A workspace that contains your integration code, dependencies, configuration, an ## Library -A shareable collection of reusable components, functions, and connectors packaged for distribution. Libraries let you build once and use across multiple projects or share with your team. For more information, see [Organize code](/docs/develop/organize-code/). +A shareable collection of reusable components, functions, and connectors packaged for distribution. Libraries let you build once and use across multiple projects or share with your team. For more information, see [Organize code](/docs/develop/organize-code/overview). ## Services and listeners diff --git a/en/docs/reference/overview.md b/en/docs/reference/overview.md index ccacf785e4..a7254bad14 100644 --- a/en/docs/reference/overview.md +++ b/en/docs/reference/overview.md @@ -59,7 +59,7 @@ Command-line tools reference: ## Specifications & Formats - **[Supported Protocols](protocols.md)** — Complete protocol support table -- **[Supported Data Formats](data-formats.md)** — Complete data format support table +- **[Supported Data Formats](data-formats/index.md)** — Complete data format support table - **[Ballerina by Example](by-example.md)** — 200+ runnable examples - **[Ballerina Specifications](specifications.md)** — Language, library, and platform specs diff --git a/en/docs/reference/protocols.md b/en/docs/reference/protocols.md index af658aa7f7..3086acc8a0 100644 --- a/en/docs/reference/protocols.md +++ b/en/docs/reference/protocols.md @@ -199,4 +199,4 @@ service "emailObserver" on imapListener { - [Ballerina API Documentation](api/ballerina-api-docs.md) -- Full API docs for all modules - [Connectors Catalog](/docs/connectors/catalog) -- Protocol connector guides -- [Data Formats](data-formats.md) -- Supported data formats +- [Data Formats](data-formats/index.md) -- Supported data formats