add note to doc about attribute handling