clarifying documentation