better documentation of properties
more verbose variable names