search

evant / binding-collection-adapter

Easy way to bind collections to listviews and recyclerviews with the new Android Data Binding framework
Apache License 2.0
1.92k stars 255 forks source link

Suggestion for documentation improvement #50

Open Dev-iL opened 8 years ago

Dev-iL commented 8 years ago

I'd like to suggest that the readme is expanded to list the benefits of using this library versus the features provided by the core databinding library. As it stands, the purpose of the library isn't very clear.

If the main claim is that "it makes things easier", perhaps a "before and after" example would be beneficial. If it adds functionality (such as allowing to choose from multiple itemViews) this should be stressed, imho.

(The other day I was trying to convince a colleague that he should be using this library, but he insisted that one needs nothing else besides the default databinding library to create bindings for RecyclerView etc. )

evant commented 8 years ago

Fair enough, documentation can always be better. Sure you can write you own adapter with databinding, but won't they all look pretty much the same? There are also some subtile implementation details that you might easily miss (https://realm.io/news/data-binding-android-boyar-mount does a good job at covering this).

The goal for this lib is to provide a similar separation and update mechanism to collections as databinding does for plain views. You can simply work on a collection of data and have it update the ui with as minimal glue code as possible.