"Please split doc into foo-doc subpackage" -> why?

[Orcan Ogetbil]

On Thu, Mar 26, 2009 at 4:14 PM, Bill Nottingham  wrote:
> I just recieved one of these bugs (#492446), and I'm not sure
> why we'd do this for any package.
>
> If we split the docs like this:
>
> - it would be inconsistent per-package
> -- so an admin wouldn't know whether a package had docs or not in
>   the main package without manually trying to install a foo-doc
>   subpackage
> -- they would no longer be there by default if they're needed
>
> Hence, why do this, when rpm already has a --nodocs flag and
> macro that can be used for space savings on live images?
>
> Bill
>

There is another inconsistency. Some -doc subpackages in Fedora
require the main package and some don't. I don't know what someone can
do with, for instance, API docs of a library without having the
library itself. But I don't see a guideline that tells that a -doc
subpackage must require the main package.

Orcan