initial commit
Merge pull request #1542 from wsargent/1542-update-scalaws

[doc] More WS documentation, worked examples