change explanations and improve examples