readme enhancements
using properties for getters / setters
refactoring