冗長さが特「長」のリファレンス書

個々のメソッドについてマーブルダイアグラムという時系列に沿った図を用いて、
サンプルコードや実行結果と共に逐一記述されています。
逆に言うと似たメソッドについて同じようなことが反復して書かれており、
かなり冗長だとも言えます。
通読するには、
似た部分を飛ばしながら読まないと辛いです。

本家のJavaDocにもマーブルダイアグラムはありますが、
英語ですし、
サンプルコードまではついていないので、
JavaDocだけでは今ひとつ細かいところに不明な点があるときに、
正確な動作を確認するために用いるとよいのではないかと思います。


一方で、
紙の本にするにはページ数がかさむためか、
具体的にどのような場面でどう使うと便利かといった話題は「RxJavaの知識があればAndroidのライブラリを扱うのはそれほど難しいことではない」と一切説明されていなかったのは残念でした。

また、
各クラスが従うべきルールについては、
おおざっぱなまとめしかありませんでしたが、
どうやってそのルールを守るのかといったことをもう少し詳しく解説して頂けると良かったのではと思いました。


Java9にFlowが標準で入ったため今後RxJavaの立場がどうなるかはわかりませんが、
とりあえずリファレンス部分の後半を流し読みにしてもRxJavaの概要は理解できたので星4つの評価とします。