Some javadoc explanations added to classes.

expanding-collection/src/main/java/com/ramotion/expandingcollection/AlphaScalePageTransformer.java

@@ -3,6 +3,9 @@
 import android.support.v4.view.ViewPager;
 import android.view.View;
 
+/**
+ * Page Transformer for main ViewPager.
+ */
 public class AlphaScalePageTransformer implements ViewPager.PageTransformer {
 
     private static final float INACTIVE_SCALE = 0.8f;

expanding-collection/src/main/java/com/ramotion/expandingcollection/BackgroundBitmapCache.java

@@ -3,9 +3,11 @@
 import android.graphics.Bitmap;
 import android.util.LruCache;
 
+/**
+ * LruCache for caching background bitmaps for {@link ECBackgroundSwitcherView}.
+ * Key is id of page from {@link ECPager} and value is background bitmap from provided data.
+ */
 public class BackgroundBitmapCache {
-    private final String TAG = "cache_manager";
-
     private LruCache<Integer, Bitmap> mBackgroundsCache;
 
     private static BackgroundBitmapCache instance;

expanding-collection/src/main/java/com/ramotion/expandingcollection/BitmapFactoryOptions.java

@@ -2,6 +2,9 @@
 
 import android.graphics.BitmapFactory;
 
+/**
+ * Bitmap Factory Options with inScaled flag disabled by default
+ */
 public class BitmapFactoryOptions extends BitmapFactory.Options {
     public BitmapFactoryOptions() {
         this.inScaled = false;

expanding-collection/src/main/java/com/ramotion/expandingcollection/BitmapWorkerTask.java

@@ -7,6 +7,9 @@
 import android.os.AsyncTask;
 import android.support.annotation.DrawableRes;
 
+/**
+ * Worker for async processing bitmaps through cache {@link BackgroundBitmapCache}
+ */
 public class BitmapWorkerTask extends AsyncTask<Integer, Void, Bitmap> {
 
     private final Resources mResources;

expanding-collection/src/main/java/com/ramotion/expandingcollection/ECBackgroundSwitcherView.java

@@ -18,6 +18,10 @@
 import android.widget.ImageView;
 import android.widget.ViewSwitcher;
 
+/**
+ * Custom Image Switcher for display and change background images with some pretty animations.
+ * Uses different drawing orders for animation purposes.
+ */
 public class ECBackgroundSwitcherView extends ImageSwitcher {
     private final int[] REVERSE_ORDER = new int[]{1, 0};
     private final int[] NORMAL_ORDER = new int[]{0, 1};
@@ -41,7 +45,6 @@ public class ECBackgroundSwitcherView extends ImageSwitcher {
 
     private BitmapWorkerTask mCurrentAnimationTask;
 
-
     public ECBackgroundSwitcherView(Context context, AttributeSet attrs) {
         super(context, attrs);
         inflateAndInit(context);

expanding-collection/src/main/java/com/ramotion/expandingcollection/ECCardContentListItemAdapter.java

@@ -10,6 +10,11 @@
 
 import java.util.List;
 
+/**
+ * Must be implemented to inflate card content list items layout.
+ *
+ * @param <T> Type of items in card content list
+ */
 public abstract class ECCardContentListItemAdapter<T> extends ArrayAdapter<T> {
     private boolean zeroItemsMode = true;
 

expanding-collection/src/main/java/com/ramotion/expandingcollection/ECCardData.java

@@ -4,6 +4,11 @@
 
 import java.util.List;
 
+/**
+ * Implement this interface to provide data to pager view and content list inside pager card
+ *
+ * @param <T> Type of items in card content list
+ */
 public interface ECCardData<T> {
 
     @DrawableRes

expanding-collection/src/main/java/com/ramotion/expandingcollection/ECPager.java

@@ -12,6 +12,11 @@
 import android.view.animation.DecelerateInterpolator;
 import android.widget.FrameLayout;
 
+/**
+ * Custom ViewPager used as main card pager, neighborhood elements are visible due to {@link ECPagerView},
+ * so this pager element used only inside {@link ECPagerView}. Also pager can change self position and size
+ * for animation purposes.
+ */
 public class ECPager extends ViewPager {
     private int currentPosition;
     private boolean pagingDisabled;

expanding-collection/src/main/java/com/ramotion/expandingcollection/ECPagerCard.java

@@ -7,6 +7,9 @@
 import android.view.ViewGroup;
 import android.widget.FrameLayout;
 
+/**
+ * Pager Card it's simple container that wraps card content list and some logic for work with animations.
+ */
 public class ECPagerCard extends FrameLayout {
 
     private ECPagerCardContentList ecPagerCardContentList;

expanding-collection/src/main/java/com/ramotion/expandingcollection/ECPagerCardContentList.java

@@ -11,6 +11,9 @@
 import android.widget.ListAdapter;
 import android.widget.ListView;
 
+/**
+ * Card content list it's main element of card content - just a list view with custom header and animations.
+ */
 public class ECPagerCardContentList extends ListView {
 
     private boolean scrollDisabled;
@@ -50,7 +53,7 @@ public ECCardContentListItemAdapter getContentListItemAdapter() {
     @Override
     public void setAdapter(ListAdapter adapter) {
         super.setAdapter(adapter);
-        if (adapter instanceof ECCardContentListItemAdapter){
+        if (adapter instanceof ECCardContentListItemAdapter) {
             this.contentListItemAdapter = (ECCardContentListItemAdapter) adapter;
         }
     }

expanding-collection/src/main/java/com/ramotion/expandingcollection/ECPagerCardHead.java

@@ -15,6 +15,10 @@
 
 import ramotion.com.expandingcollection.R;
 
+/**
+ * View used to be a card head that is visible when card is collapsed. Just frame layout with background image
+ * and logic for animate height.
+ */
 public class ECPagerCardHead extends FrameLayout {
 
     private ImageView headBackgroundImageView;

expanding-collection/src/main/java/com/ramotion/expandingcollection/ECPagerView.java

@@ -19,6 +19,9 @@
 
 import ramotion.com.expandingcollection.R;
 
+/**
+ * Root PagerView element. Wraps all logic and behavior.
+ */
 public class ECPagerView extends FrameLayout implements ViewPager.OnPageChangeListener {
     private ECPager pager;
     private ECBackgroundSwitcherView attachedImageSwitcher;

expanding-collection/src/main/java/com/ramotion/expandingcollection/ECPagerViewAdapter.java

@@ -15,6 +15,10 @@
 
 import static android.R.attr.bitmap;
 
+/**
+ * Adapter must be implemented to provide your layouts and data(that implements {@link ECCardData})
+ * to cards in {@link ECPagerView}.
+ */
 public abstract class ECPagerViewAdapter extends PagerAdapter {
 
     private ECPagerCard activeCard;