SONAR-19103 Improve New Code Definition descriptions and help texts

1 files changed, 19 insertions, 14 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 87e48c71bf9..c0564875ea2 100644
--- a/sonar-core/src/main/resources/org/sonar/l10n/core.properties
+++ b/sonar-core/src/main/resources/org/sonar/l10n/core.properties
@@ -628,25 +628,27 @@ project_branch_pull_request.table.pull_request=Pull Request
 project_branch_pull_request.last_analysis_date=Last Analysis Date
 
 project_baseline.page=New Code
-project_baseline.page.description=Use this page to define the New Code of your project. {link}
-project_baseline.page.description.link=Learn More
-project_baseline.page.description2=You can adjust this setting globally in {link}
-project_baseline.page.description2.link=General Settings
+project_baseline.page.description=The new code definition sets which part of your code will be considered new code.
+project_baseline.page.description2=You can adjust this setting globally in {link}.
+project_baseline.page.description2.link=General settings
+project_baseline.page.question=What should be the baseline for new code for this project?
 project_baseline.default_setting=Project setting
 project_baseline.general_setting=Use the general setting
 project_baseline.specific_setting=Define a specific setting for this project
 project_baseline.configure_branches=Set a specific setting for a branch
 
 baseline.previous_version=Previous version
-baseline.previous_version.description=The New Code will be based on the analysis following the previous version.
+baseline.previous_version.usecase=Recommended for projects with regular versions or releases.
+baseline.previous_version.description=All code that has changed since the previous version is considered new code.
 baseline.number_days=Number of days
-baseline.number_days.description=A floating window set to a specific number of days used to define New Code.
+baseline.number_days.usecase=Recommended for projects following continuous delivery.
+baseline.number_days.description=All code that has changed in the last x days is considered new code.
 baseline.specific_analysis=Specific analysis
-baseline.specific_analysis.description=Choose an analysis as the baseline for the New Code.
+baseline.specific_analysis.description=Choose an analysis as the baseline for the new code.
 baseline.reference_branch=Reference branch
 
-baseline.reference_branch.description=Choose a branch as the reference for the New Code.
-baseline.reference_branch.description2=The branch you select as the reference branch will need its own New Code definition to prevent it from using itself as a reference.
+baseline.reference_branch.description=Choose a branch as the baseline for the new code.
+baseline.reference_branch.description2=The branch you select as the reference branch will need its own new code definition to prevent it from using itself as a reference.
 
 baseline.specify_days=Specify a number of days
 baseline.last_analysis_before=Last analysis before
@@ -665,8 +667,8 @@ branch_list.actions=Actions
 branch_list.show_actions_for_x=Show actions for branch {0}
 branch_list.default_setting=Project setting
 
-baseline.new_code_period_for_branch_x=New Code Period for {0}
-
+baseline.new_code_period_for_branch_x=New Code for {0}
+baseline.new_code_period_for_branch_x.question=What should be the baseline for new code for this branch?
 baseline.analysis_from=Analysis from:
 baseline.branch_analyses.ranges.30days=Last 30 days
 baseline.branch_analyses.ranges.allTime=All time
@@ -1226,9 +1228,12 @@ settings.analysis_scope.wildcards.zero_more_dir=Match zero or more directories
 settings.analysis_scope.wildcards.single_char=Match a single character
 
 settings.new_code_period.category=New Code
-settings.new_code_period.title=Default New Code behavior
-settings.new_code_period.description=The New Code definition is used to compare measures and track new issues. {link}
-settings.new_code_period.description2=This setting is the default for all projects. A specific New Code definition can be configured at project level.
+settings.new_code_period.title=New Code
+settings.new_code_period.description0=The new code definition sets which part of your code will be considered new code.
+settings.new_code_period.description1=This helps you focus attention on the most recent changes to your project, enabling you to follow the Clean as You Code methodology. {link}.
+settings.new_code_period.description1.link=Learn more
+settings.new_code_period.description2=A specific new code definition can be configured at project level.
+settings.new_code_period.question=What should be the baseline for new code for all projects by default?
 
 settings.languages.select_a_language_placeholder=Select a language