added documentation about the new properties