https://fedoraproject.org/wiki/Packaging:Guidelines#Documentation
Proposed addition to the guidelines:
Independent documentation -doc packages typically don't require the base package. It should be possible to install documentation without having to install a program and all its dependencies.
Rationale: Recently, in package review requests, I've seen packagers apply https://fedoraproject.org/wiki/Packaging:Guidelines#Requiring_Base_Package also to -doc packages. And there are packages in the collection, which do that, too. This is a hindrance, especially if one only wants to peruse the documentation or install API documentation for remote developing. Of course, an exception to this is documentation in a special format, which can only be viewed within an application.
Thoughts?
On 10 June 2013 09:22, Michael Schwendt mschwendt@gmail.com wrote:
https://fedoraproject.org/wiki/Packaging:Guidelines#Documentation
Proposed addition to the guidelines:
Independent documentation -doc packages typically don't require the base package. It should be possible to install documentation without having to install a program and all its dependencies.
Perfectly agree!
Regards, --Simone
Quoting Michael Schwendt (2013-06-10 09:22:31)
https://fedoraproject.org/wiki/Packaging:Guidelines#Documentation
Proposed addition to the guidelines:
Independent documentation -doc packages typically don't require the base package. It should be possible to install documentation without having to install a program and all its dependencies.Rationale: Recently, in package review requests, I've seen packagers apply https://fedoraproject.org/wiki/Packaging:Guidelines#Requiring_Base_Package also to -doc packages. And there are packages in the collection, which do that, too. This is a hindrance, especially if one only wants to peruse the documentation or install API documentation for remote developing. Of course, an exception to this is documentation in a special format, which can only be viewed within an application.
Thoughts?
I know I know...Java has to be special case so our -doc packages are called -javadoc. Can we somehow make the wording a bit more generic? (getting rid of "-doc")
Dne 10.6.2013 09:22, Michael Schwendt napsal(a):
https://fedoraproject.org/wiki/Packaging:Guidelines#Documentation
Proposed addition to the guidelines:
Independent documentation -doc packages typically don't require the base package. It should be possible to install documentation without having to install a program and all its dependencies.Rationale: Recently, in package review requests, I've seen packagers apply https://fedoraproject.org/wiki/Packaging:Guidelines#Requiring_Base_Package also to -doc packages. And there are packages in the collection, which do that, too. This is a hindrance, especially if one only wants to peruse the documentation or install API documentation for remote developing. Of course, an exception to this is documentation in a special format, which can only be viewed within an application.
Thoughts?
For rubygem- packages, we are used to put a lot of stuff not needed for runtime into -doc subpackage. That would mean to pay more attention to directory ownership. Not sure if the proposal would make the situation better.
Vít
packaging@lists.fedoraproject.org
-
Michael Schwendt -
Simone Caronni -
Stanislav Ochotnicky -
Vít Ondruch