DOCS: explaining why I put a dot in the variable names
DOCS: explaining why long format is better