Add/improve docstrings for assertions.
Merge pull request #1479 from rhattersley/assert-docstrings

Add/improve docstrings for assertions.