adding some notes about common problems