SONAR-3755 add javadoc to issue API

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/issue/Issue.java b/sonar-plugin-api/src/main/java/org/sonar/api/issue/Issue.java
index 527fccd84bf43ab611fe9c1f1a03128cacbbb140..982ed14ff94944ffee860d3c9a18dab09c099b7f 100644 (file)
--- a/sonar-plugin-api/src/main/java/org/sonar/api/issue/Issue.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/issue/Issue.java
@@ -67,10 +67,17 @@ public interface Issue extends Serializable {
    */
   String key();
 
+  /**
+   * Components are modules ("my_project"), directories ("my_project:my/dir") or files ("my_project:my/file.c").
+   * Keys of Java packages and classes are currently in a special format: "my_project:com.company" and "my_project:com.company.Foo".
+   */
   String componentKey();
 
   RuleKey ruleKey();
 
+  /**
+   * See constants in {@link org.sonar.api.rule.Severity}.
+   */
   String severity();
 
   @CheckForNull