diff --git a/scm-webapp/src/main/java/sonia/scm/api/rest/resources/SearchResource.java b/scm-webapp/src/main/java/sonia/scm/api/rest/resources/SearchResource.java
index 4b65b3ba77..a00ee6344b 100644
--- a/scm-webapp/src/main/java/sonia/scm/api/rest/resources/SearchResource.java
+++ b/scm-webapp/src/main/java/sonia/scm/api/rest/resources/SearchResource.java
@@ -145,10 +145,14 @@ public class SearchResource implements UserListener, GroupListener
   }
 
   /**
-   * Method description
+   * Returns a list of groups found by the given search string.<br />
+   * <br />
+   * <ul>
+   *   <li>200 success</li>
+   *   <li>500 internal server error</li>
+   * </ul>
    *
-   *
-   * @param queryString
+   * @param queryString the search string
    *
    * @return
    */
@@ -177,10 +181,14 @@ public class SearchResource implements UserListener, GroupListener
   }
 
   /**
-   * Method description
+   * Returns a list of users found by the given search string.<br />
+   * <br />
+   * <ul>
+   *   <li>200 success</li>
+   *   <li>500 internal server error</li>
+   * </ul>
    *
-   *
-   * @param queryString
+   * @param queryString the search string
    *
    * @return
    */