clarify some documentation