diff --git a/docs/docs/core-abilities/fetching_ticket_context.md b/docs/docs/core-abilities/fetching_ticket_context.md index 6fb787b7..7ada1685 100644 --- a/docs/docs/core-abilities/fetching_ticket_context.md +++ b/docs/docs/core-abilities/fetching_ticket_context.md @@ -12,6 +12,7 @@ This integration enriches the review process by automatically surfacing relevant - [GitHub/Gitlab Issues](https://qodo-merge-docs.qodo.ai/core-abilities/fetching_ticket_context/#githubgitlab-issues-integration) - [Jira (💎)](https://qodo-merge-docs.qodo.ai/core-abilities/fetching_ticket_context/#jira-integration) - [Linear (💎)](https://qodo-merge-docs.qodo.ai/core-abilities/fetching_ticket_context/#linear-integration) +- [Monday (💎)](https://qodo-merge-docs.qodo.ai/core-abilities/fetching_ticket_context/#monday-integration) **Ticket data fetched:** @@ -451,3 +452,49 @@ Name your branch with the ticket ID as a prefix (e.g., `ABC-123-feature-descript ``` Replace `[ORG_ID]` with your Linear organization identifier. + +## Monday Integration 💎 + +### Monday App Authentication +The recommended way to authenticate with Monday is to connect the Monday app through the Qodo Merge portal. + +Installation steps: +1. Go to the [Qodo Merge integrations page](https://app.qodo.ai/qodo-merge/integrations) +2. Navigate to the **Integrations** tab +3. Click on the **Monday** button to connect the Monday app +4. Follow the authentication flow to authorize Qodo Merge to access your Monday workspace +5. Once connected, Qodo Merge will be able to fetch Monday ticket context for your PRs + +### Monday Ticket Context +`Ticket Context and Ticket Compliance is supported for Monday items, but not yet available in "PR to Ticket" feature.` + +When Qodo Merge processes your PRs, it extracts the following information from Monday items: + +* **Item ID and Name:** The unique identifier and title of the Monday item +* **Item URL:** Direct link to the Monday item in your workspace +* **Ticket Description:** All long text type columns and their values from the item +* **Status and Labels:** Current status values and color-coded labels for quick context +* **Sub-items:** Names, IDs, and descriptions of all related sub-items with hierarchical structure + +### How Monday Items are Detected +Qodo Merge automatically detects Monday items from: + +* PR Descriptions: Full Monday URLs like https://workspace.monday.com/boards/123/pulses/456 +* Branch Names: Item IDs in branch names (6-12 digit patterns) - requires `monday_base_url` configuration + +### Configuration Setup (Optional) +If you want to extract Monday item references from branch names or use standalone item IDs, you need to set the `monday_base_url` in your configuration file: + +Branch Names: Item IDs (6-12 digits) in branch names - requires monday_base_url configuration + +```toml +[monday] +monday_base_url = "https://your_monday_workspace.monday.com" +``` + +Examples of supported branch name patterns: + +* `feature/123456789` → extracts item ID 123456789 +* `bugfix/456789012-login-fix` → extracts item ID 456789012 +* `123456789` → extracts item ID 123456789 +* `456789012-login-fix` → extracts item ID 456789012