SONAR-14873 Ease comprehension of PR Decoration settings form

1 files changed, 14 insertions, 12 deletions

diff --git a/sonar-core/src/main/resources/org/sonar/l10n/core.properties b/sonar-core/src/main/resources/org/sonar/l10n/core.properties
index 774264c96a9..9c77337826f 100644
--- a/sonar-core/src/main/resources/org/sonar/l10n/core.properties
+++ b/sonar-core/src/main/resources/org/sonar/l10n/core.properties
@@ -1170,25 +1170,27 @@ settings.pr_decoration.binding.title=DevOps Platform Integration
 settings.pr_decoration.binding.description=Display your Quality Gate status directly in your DevOps Platform. 
 settings.pr_decoration.binding.form.url=Project location
 settings.pr_decoration.binding.form.name=Configuration name
+settings.pr_decoration.binding.form.name.help=Each DevOps Platform instance must be configured globally first, and given a unique name. Pick the instance your project is hosted on.
 settings.pr_decoration.binding.form.monorepo=Enable mono repository support
 settings.pr_decoration.binding.form.monorepo.help=Enable this setting if your project is part of a mono repository. {doc_link}
 settings.pr_decoration.binding.form.monorepo.warning=This setting must be enabled for all SonarQube projects that are part of a mono repository.
-settings.pr_decoration.binding.form.azure.project=Project Name
-settings.pr_decoration.binding.form.azure.project.help=The name of the Azure DevOps project containing your repository.
-settings.pr_decoration.binding.form.azure.repository=Repository Name
-settings.pr_decoration.binding.form.azure.repository.help=The name of your Azure DevOps repository.
-settings.pr_decoration.binding.form.github.repository=Repository identifier
-settings.pr_decoration.binding.form.github.repository.help=The path of your repository URL. Example: {example}
+settings.pr_decoration.binding.form.azure.project=Project name
+settings.pr_decoration.binding.form.azure.project.help=The name of the Azure DevOps project containing your repository. You can find this name on your project's Overview page.
+settings.pr_decoration.binding.form.azure.repository=Repository name
+settings.pr_decoration.binding.form.azure.repository.help=The name of your Azure DevOps repository. You can find this name on your project's Repos page.
+settings.pr_decoration.binding.form.github.repository=Repository name
+settings.pr_decoration.binding.form.github.repository.help=The full name of your repository, including the organization. You can find this name in your repository's URL. This name is case-sensitive! 
 settings.pr_decoration.binding.form.github.summary_comment_setting=Enable analysis summary under the GitHub Conversation tab
 settings.pr_decoration.binding.form.github.summary_comment_setting.help=When enabled, a summary is displayed under the GitHub Conversation tab. Notifications may be sent by GitHub depending on your settings.
-settings.pr_decoration.binding.form.bitbucket.repository=Project Key
-settings.pr_decoration.binding.form.bitbucket.repository.help=The project key is part of your Bitbucket Server repository URL. Example: ({example})
-settings.pr_decoration.binding.form.bitbucket.slug=Repository SLUG
-settings.pr_decoration.binding.form.bitbucket.slug.help=The Repository Slug is part of your Bitbucket Server repository URL. Example: ({example})
-settings.pr_decoration.binding.form.bitbucketcloud.repository=Repository SLUG
-settings.pr_decoration.binding.form.bitbucketcloud.repository.help=The Repository SLUG is part of your Bitbucket Cloud URL. Example: {example}
+settings.pr_decoration.binding.form.bitbucket.repository=Project key
+settings.pr_decoration.binding.form.bitbucket.repository.help=The project key is part of your Bitbucket Server repository URL. This is case-sensitive!
+settings.pr_decoration.binding.form.bitbucket.slug=Repository slug
+settings.pr_decoration.binding.form.bitbucket.slug.help=The repository slug is part of your Bitbucket Server repository URL. This slug is case-sensitive!
+settings.pr_decoration.binding.form.bitbucketcloud.repository=Repository slug
+settings.pr_decoration.binding.form.bitbucketcloud.repository.help=The repository slug is part of your Bitbucket Cloud repository URL.
 
 settings.pr_decoration.binding.form.gitlab.repository=Project ID
+settings.pr_decoration.binding.form.gitlab.repository.help=The Project ID is a numerical unique identifier for your project. You can find it on your Project Overview.
 
 property.category.general=General
 property.category.general.email=Email