variable naming and documentation

closer to pep8, and standardized variable names