clarify some docs