From 359cbe860a488ef909d3358263cef980221e5432 Mon Sep 17 00:00:00 2001 From: NoyaOffer Date: Thu, 14 May 2026 15:55:50 +0300 Subject: [PATCH] docs: document configurable project repo PR settings Describe per-project options for labels, commit and branch prefixes, and ticket ID requirements. Note that required ticket ID is prepended to branch names and PR titles for Elementary-opened pull requests. Co-authored-by: Cursor --- docs/cloud/integrations/code-repo/azure-devops.mdx | 4 ++++ docs/cloud/integrations/code-repo/bitbucket.mdx | 3 +++ docs/cloud/integrations/code-repo/connect-code-repo.mdx | 3 +++ docs/cloud/integrations/code-repo/github.mdx | 3 +++ docs/cloud/integrations/code-repo/gitlab.mdx | 5 ++++- docs/snippets/cloud/integrations/project-repo-settings.mdx | 7 +++++++ 6 files changed, 24 insertions(+), 1 deletion(-) create mode 100644 docs/snippets/cloud/integrations/project-repo-settings.mdx diff --git a/docs/cloud/integrations/code-repo/azure-devops.mdx b/docs/cloud/integrations/code-repo/azure-devops.mdx index 0784986ac..62de0bece 100644 --- a/docs/cloud/integrations/code-repo/azure-devops.mdx +++ b/docs/cloud/integrations/code-repo/azure-devops.mdx @@ -3,6 +3,8 @@ title: "Azure DevOps Integration" sidebarTitle: "Azure DevOps" --- +import ProjectRepoSettings from '/snippets/cloud/integrations/project-repo-settings.mdx'; + Elementary can integrate with Azure DevOps to connect to the code repository where your **dbt project code** is managed, and it opens pull requests with configuration changes. ## Connecting Through the Azure DevOps App @@ -32,6 +34,8 @@ Elementary requires the following permissions in your Azure DevOps **dbt reposit - Access to **file contents** - Permission to **open and read pull requests** + + --- ## Troubleshooting diff --git a/docs/cloud/integrations/code-repo/bitbucket.mdx b/docs/cloud/integrations/code-repo/bitbucket.mdx index d44d7d0fa..613e148ad 100644 --- a/docs/cloud/integrations/code-repo/bitbucket.mdx +++ b/docs/cloud/integrations/code-repo/bitbucket.mdx @@ -3,6 +3,7 @@ title: "Bitbucket" --- import RepoConnectionSettings from '/snippets/cloud/integrations/repo-connection-settings.mdx'; +import ProjectRepoSettings from '/snippets/cloud/integrations/project-repo-settings.mdx'; @@ -24,3 +25,5 @@ If connecting the Elementary Bitbucket App isn't an option, you can connect usin ## Repository connection settings + + diff --git a/docs/cloud/integrations/code-repo/connect-code-repo.mdx b/docs/cloud/integrations/code-repo/connect-code-repo.mdx index 116b83ea9..cfc1d4cd4 100644 --- a/docs/cloud/integrations/code-repo/connect-code-repo.mdx +++ b/docs/cloud/integrations/code-repo/connect-code-repo.mdx @@ -4,6 +4,7 @@ sidebarTitle: "Code integration" --- import CodeRepoCards from '/snippets/cloud/integrations/cards-groups/code-repo-cards.mdx'; +import ProjectRepoSettings from '/snippets/cloud/integrations/project-repo-settings.mdx'; @@ -14,6 +15,8 @@ Adding and updating configuration becomes part of your development process. Through integration and access to the dbt project code repository, Elementary opens pull requests to your dbt project. + + ### Supported code repositories diff --git a/docs/cloud/integrations/code-repo/github.mdx b/docs/cloud/integrations/code-repo/github.mdx index b8a8ed61e..19f906b33 100644 --- a/docs/cloud/integrations/code-repo/github.mdx +++ b/docs/cloud/integrations/code-repo/github.mdx @@ -3,6 +3,7 @@ title: "Github" --- import RepoConnectionSettings from '/snippets/cloud/integrations/repo-connection-settings.mdx'; +import ProjectRepoSettings from '/snippets/cloud/integrations/project-repo-settings.mdx'; @@ -56,3 +57,5 @@ If connecting the Elementary Github App isn't an option, you can connect to Gith ## Repository connection settings + + diff --git a/docs/cloud/integrations/code-repo/gitlab.mdx b/docs/cloud/integrations/code-repo/gitlab.mdx index 4f65c192f..388d07f3c 100644 --- a/docs/cloud/integrations/code-repo/gitlab.mdx +++ b/docs/cloud/integrations/code-repo/gitlab.mdx @@ -3,6 +3,7 @@ title: "Gitlab" --- import RepoConnectionSettings from '/snippets/cloud/integrations/repo-connection-settings.mdx'; +import ProjectRepoSettings from '/snippets/cloud/integrations/project-repo-settings.mdx'; @@ -38,4 +39,6 @@ You need to create a [project access token](https://docs.gitlab.com/ee/user/proj ## Repository connection settings - \ No newline at end of file + + + \ No newline at end of file diff --git a/docs/snippets/cloud/integrations/project-repo-settings.mdx b/docs/snippets/cloud/integrations/project-repo-settings.mdx new file mode 100644 index 000000000..b2be8e175 --- /dev/null +++ b/docs/snippets/cloud/integrations/project-repo-settings.mdx @@ -0,0 +1,7 @@ +## Project repository settings + +Repository settings are configurable per project. You can set **labels**, **commit message prefix**, **branch prefix**, and **ticket ID requirements** for pull requests Elementary opens. + + +When **required ticket ID** is enabled, every pull request Elementary opens must include a ticket ID. The ticket ID is prepended to the branch name and the pull request title. +