Move the examples from ScalaFunctionalTest.md out to a spec.  Clean up the documentation and show the usage of withRoutes.
Merge pull request #1594 from wsargent/1594-add-withroutes

[doc] Add section on testing WS to ScalaFunctionalTest.md