Add missing javadoc comment inside OnItemClickListener class (#89)

Author: DevAhamed

multi-view-adapter/src/main/java/mva2/adapter/decorator/Decorator.java

@@ -34,7 +34,7 @@
 
 /**
  * A Decorator allows the application to add a special drawing and layout offset to specific
- * itemviews from the adapter's data set.
+ * item views from the adapter's data set.
  * This can be useful for drawing dividers between items, highlights and more.
  *
  * <p>
@@ -49,9 +49,9 @@
   private MultiViewAdapter adapter;
 
   /**
-   * Constructor which initialized the Decorator with the adapter object.
+   * Constructor which initializes the Decorator with the adapter object.
    *
-   * @param adapter MultiViewAaapter that is attached with this decorator.
+   * @param adapter MultiViewAdapter that is attached with this decorator.
    */
   public Decorator(MultiViewAdapter adapter) {
     this.adapter = adapter;
@@ -74,7 +74,10 @@ public void addToRect(Rect outRect, int left, int top, int right, int bottom) {
   }
 
   /**
-   * Returns the position type of the item for given adapter position.
+   * Returns the position type of the item for given adapter position. PositionType lets you
+   * identify specific information about the position of the item inside the adapter. For example
+   * you can use PositionType to find whether the item lies on the left or right or top or bottom
+   * edge of the adapter.
    *
    * @param adapterPosition Item position inside the adapter for which position type is calculated
    * @param parent          Parent recyclerview

multi-view-adapter/src/main/java/mva2/adapter/util/OnItemClickListener.java

@@ -16,9 +16,19 @@
 
 package mva2.adapter.util;
 
+import mva2.adapter.ItemSection;
+import mva2.adapter.ItemViewHolder;
+import mva2.adapter.ListSection;
+
 /**
+ * This interface lets you listen to the click event of the items inside the ListSection or
+ * ItemSection. You can attach this listener to the section and listen for click events. To pass
+ * down the click events to this interface call {@link ItemViewHolder#onClick()} method.
+ *
+ * @param <M> Model used in the {@link ListSection} or {@link ItemSection} where this listener is
+ *            attached.
  *
- * @param <M>
+ * @see ItemViewHolder#onClick()
  */
 public interface OnItemClickListener<M> {