renaming the properties, adding more docs