added initial documentation for properties expansion