Added more docstrings after some more thinking.

Getting the messaging right is going to require a LOT of experimentation. It's
definitely not going to be right the first go-around.