Added more docstrings after some more thinking.
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.

oubiwann/peloid