docs clarifications.