update some documentation