naming rules
fix short variables
add description of rules