add commentary at the top of the readme