Issue #2687 [Docs] update of "Calling Web Services" docs.

This Fixes #2687. Update is primarily for Java WS docs to match Scala WS docs, but there are a few improvements to the Scala WS docs to keep consistency.