Diagrams and some new javadoc content for Observable subclasses

Some marble or marblish diagrams and a bit of new documentation for the
BlockingObservable and ConnectableObservable subclasses.