Clarify notifications spec and code

Address feedback from pingu in #37.