Documentation and improvements to notifications