clarifications to documentation