SONAR-4915 add javadoc to RulesDefinition#setEffortToFixDescription(String)

1 files changed, 9 insertions, 0 deletions

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/server/rule/RulesDefinition.java b/sonar-plugin-api/src/main/java/org/sonar/api/server/rule/RulesDefinition.java
index c7bd5ce3c99..d2470d6eabf 100644
--- a/sonar-plugin-api/src/main/java/org/sonar/api/server/rule/RulesDefinition.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/server/rule/RulesDefinition.java
@@ -614,6 +614,15 @@ public interface RulesDefinition extends ServerExtension {
       return this;
     }
 
+    /**
+     * For rules that use "Linear"/"Linear with offset" remediation functions, the meaning
+     * of the function parameter (= "effort to fix") must be set. This description
+     * explains what 1 point of "effort to fix" represents for the rule.
+     * <p/>
+     * Example : : for the "Insufficient branch coverage", this description for the
+     * remediation function coefficient/offset would be something like
+     * "Effort to test one uncovered branch".
+     */
     public NewRule setEffortToFixDescription(@Nullable String s) {
       this.effortToFixDescription = s;
       return this;