SPARK-4040. Update documentation to exemplify use of local (n) value, fo...

This is a minor docs update which helps to clarify the way local[n] is used for streaming apps.  
Minor: `/**` is javadoc syntax, but, a few lines of comments should probably use `//`. It makes block-commenting-out easier.