Property decorator documentation is inaccurate?

From the official docs about property decorators:

“The return value is ignored too.”

But the following example returns a new descriptor, and it works fine:

class Greeter {
  @logProperty
  greeting;
}

function logProperty(target, key): any {
    var value;

    var getter = function() {
      console.log('getter');
      return value;
    };

    var setter = function(newVal) {
      value = newVal;
    };

    return {
      get: getter,
      set: setter,
      enumerable: true,
      configurable: true
    };
}

const g = new Greeter();
const b = g.greeting;

[NetanelBasal]

Agree. They explain why in the docs:

"This is because there is currently no mechanism to describe an instance property when defining members of a prototype, and no way to observe or modify the initializer for a property. "

[fatcerberus]

I meant “pitfall” in the sense of being a footgun, people might not expect instance properties to get moved to the prototype just because they added a decorator 😉