Tweaked scaladoc of matchers and assertions, primarily to document
newly added such as shouldNot compile and assertTypeError, but also
things that were left out like be (sorted) and credits.