I've started writing up wiki pages for detailing what's the difference between 1.x and 2.x: https://github.com/ReactiveX/RxJava/wiki/What's-different-in-2.0 ~~https://github.com/ReactiveX/RxJava/wiki/What's-different-in-2.0-(draft)~~ Let me know what else to describe from a library user's perspective.