add more about properties
rearrange some of the documentation
rearrange some of the documentation