- Added documentation, CHANGELOG, FEATURES, and bumped public version for the new feature

Author: dvdciri

CHANGELOG.md

@@ -15,6 +15,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 - Added possibility to let the library handle the savedInstanceState in order to keep the selection in place when orientation
 and other configuration change
 - Added `deselect(int position)` method to the MultiChoiceAdapter
+- Added `refreshDataSet()` method to the MultiChoiceAdapter in order to be able to keep a valid internal state of the selected/deselected items. This will then delegate the actual `RecyclerView.Adapter#notifyDataSetChanged()` to do the rest.
+
 
 ### Fixed
 ### Deleted

FEATURES.md

@@ -85,4 +85,7 @@ It will automatically keep the selection in place when orientation and other con
 
         // Mode
         boolean isInSingleClickMode()
+
+        // Extra
+        void refreshDataSet()
 ```

library/multichoicerecyclerview/build.gradle

@@ -8,7 +8,7 @@ checkstyle {
 }
 
 ext {
-    PUBLISH_VERSION = '2.3.0'
+    PUBLISH_VERSION = '2.4.0'
     SUPPORT_LIBRARY_VERSION = '24.2.1'
     BUILD_TOOLS = "25.0.0"
     TARGET_SDK = 23

library/multichoicerecyclerview/src/main/java/com/davidecirillo/multichoicerecyclerview/MultiChoiceAdapter.java

@@ -168,7 +168,8 @@ public void onRestoreInstanceState(Bundle savedInstanceState) {
     }
 
     /**
-     *
+     * Use this method instead of {@link RecyclerView.Adapter#notifyDataSetChanged()}
+     * and it'll automatically handle the list refresh without loosing current item state
      */
     public void refreshDataSet() {
         refreshDataSetInternal();