[docs] Docs rendering for properties is broken

[AKuederle]

We are kind of inconsistent in tpcp, if we document properties in the docstring or in the property definition itself.

The docs at the moment seem to favor the method docstring over the attributes section in the class.
However, in most cases we want to have it the other way around...