https://bugzilla.redhat.com/show_bug.cgi?id=483663
--- Comment #32 from Michael Schwendt bugs.michael@gmx.net --- Re: comment 28
Doubtful that there will ever be guidelines that suggest/mandate putting subpackage documentation into %_pkgdocdir. That would be a Herculean task for some packages [1], considering that you would have to %exclude lots of files and directories as not to duplicate files in multiple packages.
[1] Packages, which put many files directly into the top doc directory and/or which distinguish between user docs and developer docs.
Where all docs can be packaged in %_pkgdocdir without a lot effort, that's convenient for the package users, however, IMO.
package-review@lists.fedoraproject.org