Documentation is copied from property to its getter and setter and it often doesn't fit there. However, the text should be copied to be seen in code-completion hints in IDE. The doclet should generate something like "{G|S}ets the value of the property XYZProperty." and then secion "Property description" with the copied text.