clarifying docs