[doc] More cleanup on ScalaFunctionalTest.md

Make the WithBrowser text block an actual working spec.
Make all the ScalaFunctionalTest.md code snippets start with "scalafunctionaltest"
Other documentation tweaks.