Observable documentation (ScalaDoc) fixes

This pull request contains a few fixes to Observable documentation (mostly api changes that was made at some point and was not reflected in the ScalaDoc).