update samples with explanations & better consistency