ScalaTest provides a wide variety of testing styles. While ScalaWebTest only uses FlatSpec in its own integration tests, it supports all testing styles, which are available from ScalaTest.
When a gauge doesn't fit, one or more misfit messages are returned. They give you hints where you resource might fit the gauge, after a small change. Imagine you expected a link to contain a certain class and text. If this isn't the case ScalaWebTest will for example present you all links which had the correct class, but didn't contain the text you expected.
We worked a lot on the documentation. As this is mostly contained on our website, users of all ScalaWebTest versions profit from this.