docs($q): document notify behavior

Closes #3341