some documentation improvements