update some doc formatting and copy