Publish more/better documentation

[rickclephas]

[rickclephas]

Should include documentation about the restrictions of the annotations when used with open functions/properties.
A.k.a. issues with multiple generated extensions for different subclasses.