clean up docs. add references