FlatSpec ScalaDoc/Examples

Adjusted scaladoc and examples in FlatSpec and fixture.FlatSpec.