README: describe `share` and more on properties
Merge remote-tracking branch 'upstream/master'