adding user notifications and add more documentation