revised some of the intro doc