more docs and a better constructor for notice