Better examples to reuse Umbraco directives

[cmwalolo]

I was trying to figure out how to bind a value of a property using the umb-property-editor directive. No way with google, or with the documentation to find the information. Looking into the code I found out that the value is stored into the bound PropertyType, which personally, i think it sounds weird that the value and the property definition are in the same class.

Better examples should be found. Using the content picker there are plenty options that are not in the documentation for instance: The use of single/multi picker. The output format => Json, CSV ... Id or UID ?