added documentation about the new properties

I forgot to add documentation to that last PR, so here it is.