some explanations & typos