better documentation for notify