add an example to readme
add phpdoc for new property