minor documentation clarifications