improve and correct some documentation