Karthikeyan Singaravelan added the comment: Currently docstring written for even property.setter is ignored in help as inspect.getdoc only inspects property.fget [0] for docstrings. I feel docs for setter could also be included. The docs also indicate the same at https://docs.python.org/3.6/library/functions.html#property . In the absence of docs maybe the signature for getter and setter could be included as per this proposal. class Foo: @property def bar(self) -> int: '''Bar docs for property''' return 42 @bar.setter def bar(self, value: int) -> None: '''Bar docs for setter''' pass help(Foo.bar) Help on property: Bar docs for property [0] https://github.com/python/cpython/blob/4b3b1226e86df6cd45e921c8f2ad23c3639c4... ---------- nosy: +rhettinger, xtreak versions: -Python 3.5, Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker https://bugs.python.org/issue39125 _______________________________________

Change by Nguyễn Gia Phong : ---------- versions: +Python 3.9 _______________________________________ Python tracker https://bugs.python.org/issue39125 _______________________________________

Raymond Hettinger added the comment:

Currently there is no way to tell if the *attribute* is read-only, read-write or write-only.

Read-only is segregated in the help() output.

...

...

class A: @property def computed_field(self): 'An example property'

...

...

help(A) Help on class A in module __main__:

class A(builtins.object) | Readonly properties defined here: | | computed_field | An example property | | ---------------------------------------------------------------------- | Data descriptors defined here: | | __dict__ | dictionary for instance variables (if defined) | | __weakref__ ---------- _______________________________________ Python tracker https://bugs.python.org/issue39125 _______________________________________