docs clarified