improving some documentation