Javadoc improvements:
* diagrams for switchCase, doWhile, whileDo, ifThen, delaySubscription, single, singleOrDefault, takeFirst, takeLast (and variant forms of these)
* standardizing javadoc comment formatting
* standardizing nomenclature
Merge pull request #669 from Netflix/docs

Javadoc improvements: