Attempt to improve godocs for notify.go

Probably the length explanation in README.rst should be moved here
somehow, but boy does godoc look disappointing..