Which is the correct way of documenting getter & setter separately?

var value: T
    /**
     * Returns current value.
     */
    get <-- 'redundant getter'
    /**
     * Changes value and notifies listeners. Will break current binding, if any.
     */
    set <-- 'redundant setter'

UPD: found: https://youtrack.jetbrains.com/issue/KT-17962

Why do you need to document getter and setter? I would document a property instead.

Because the setter has an important side-effect which I want to describe. Finally, documented a property.

the setter has an important side-effect

🤔

The property is observable. The side-effect is observers notification. Anything wrong? 🙂

not wrong, uncommon now i understand why you want to document it