In #1906474: [policy adopted] Stop documenting methods with "Overrides …" we decided to support inheritdocs but in #1906474-35: [policy adopted] Stop documenting methods with "Overrides …" agreed to only use them alone.
I propose to revise this.
See http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutoria...
Most people are either using it this way already, and i dont think many know this limitation of api module..or people that know it, just use inheritdoc and avoid extra description (like me)