Improve assert expression documentation.

Per discussion on forum.
This could probably benefit from saying "fixed *in the source code*", so it's perfectly clear that this is not fixable by catching an `AssertError`.