[Misc] Add javadoc to all public methods

xwiki-platform-core/xwiki-platform-eventstream/xwiki-platform-eventstream-api/src/main/java/org/xwiki/eventstream/query/SortableEventQuery.java

@@ -37,7 +37,7 @@
 public interface SortableEventQuery extends EventQuery
 {
     /**
-     * The sort close to apply to the found events.
+     * The sort clause to apply to the found events.
      * 
      * @version $Id$
      */
@@ -65,6 +65,10 @@ public enum Order
 
         private final Order order;
 
+        /**
+         * @param property see {@link #getProperty}
+         * @param order see {@link #getOrder}
+         */
         public SortClause(String property, Order order)
         {
             this.property = property;
@@ -80,7 +84,7 @@ public String getProperty()
         }
 
         /**
-         * @return the order to apply
+         * @return the order to apply (ascending or descending)
          */
         public Order getOrder()
         {
@@ -121,7 +125,7 @@ public String toString()
     }
 
     /**
-     * @return the sort closes
+     * @return the sort clauses
      */
     List<SortClause> getSorts();
 }

xwiki-platform-core/xwiki-platform-ratings/xwiki-platform-ratings-api/src/main/java/org/xwiki/ratings/RatingsManager.java

@@ -61,6 +61,9 @@ enum RatingQueryField
             this.fieldName = fieldName;
         }
 
+        /**
+         * @return the name of the field used for filtering Rating queries.
+         */
         public String getFieldName()
         {
             return this.fieldName;