Add 'how it works' and update gotcha #1