Added clarifications to the documentation