soft_assert helper functions (and docs!)

Hopefully these make soft_assert more useful.
Merge pull request #660 from seandst/soft-asserts

soft_assert helper functions (and docs!)