inspect.getdoc's helper _finddoc raises an AttributeError on encountering a property, which is silently discarded.>>> class Foo(object):...     @property...     def foo(self):...         """foobar."""...         return 'foo'... >>> class Bar(Foo):...     @property...     def foo(self):...         return 'bar'... >>> import inspect>>> inspect.getdoc(Foo.foo)'foobar.'>>> inspect.getdoc(Bar.foo)>>>How I came upon this was doing static code analysis, and the f.fget on line 522 here looks very wrong.http://bugs.python.org/review/15582/diff/14140/Lib/inspect.pyThis code dedicated to supporting `property` does not work because of that, but also because a property is also a data descriptor so the 'property' branch is never executed.>>> inspect.isdatadescriptor(property())True

New changesetbbf00faf25ff by Serhiy Storchaka in branch '3.5':Issue#25503: Fixed inspect.getdoc() for inherited docstrings of properties.https://hg.python.org/cpython/rev/bbf00faf25ffNew changesete80d1e9737d4 by Serhiy Storchaka in branch 'default':Issue#25503: Fixed inspect.getdoc() for inherited docstrings of properties.https://hg.python.org/cpython/rev/e80d1e9737d4

Thank you John for your report and your patch.Committed tests are slightly changed because "contradiction" was originally purposed to test properties.