add get and set to be API compliant
add documentation to push