add explanations for methods, clean files