update samples (P2) with explanations & better consistency