Update Test annotation Javadoc to mention ExpectedException

[kcooney]

It's generally agreed that using the expected attribute of the @Test annotation can be problematic. At the very least, it's very limiting. We should update the @Test Javadoc to mention ExpectedException as the preferred alternative.

See #801 for details