some documentation, added some missing properties