add docs on notifications

Please review the api first