Fix some confusing language and code examples

Looks like this file was created by copying parts of `doOnError` and `doOnCompleted` documentation :)
Merge pull request #360 from submitteddenied/patch-1

Fix some confusing language and code examples