Bug 984018

Summary:	Missing python3 documentation
Product:	[Fedora] Fedora	Reporter:	thcourbon <thcourbon>
Component:	python3	Assignee:	Bohuslav "Slavek" Kabrda <bkabrda>
Status:	CLOSED ERRATA	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	19	CC:	amcnabb, bkabrda, tomspur
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	python3-docs-3.3.2-2.fc20	Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2013-11-10 07:58:33 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1004337
Bug Blocks:

Description thcourbon 2013-07-12 14:17:06 UTC

Description of problem:
Python 2.7.x is present in Fedora along with a compagnion package for documentation name python-docs. The same is not true for python3 for which the documentation is neither in a python3-docs package nor included in the python3 package.

Version-Release number of selected component (if applicable):
python3, all version

How reproducible:
always

Steps to Reproduce:
1. Install python3.
2. look for installed documentation, can't find it.
3. search for python3-docs package : can't find it.

Actual results:
No documentation for python3 can be installed for off-line use.

Expected results:
At the very last a python3-docs package, at best the documentation included with the interpreter (see http://blog.smartbear.com/careers/13-things-people-hate-about-your-open-source-docs/, point 4).

Additional info:
Yes, I know that the documentation can be downloaded from Python website, and that's what I did as a workaround. But then, what's the point of a distribution if you have to get by hand the thing you need ?

Comment 1 Bohuslav "Slavek" Kabrda 2013-07-18 14:15:22 UTC

You're absolutely right, we should ship python3-docs package in the same way we ship python-docs. I'll try to package it ASAP.

Comment 2 thcourbon 2013-07-19 14:23:39 UTC

That would be awesome. Any way I can help ? I don't even know how to write a spec file nor where and to who I could submit it...

Comment 3 Bohuslav "Slavek" Kabrda 2013-07-24 06:59:57 UTC

So, if you've got a _lot_ of time, you can even become a packager [1] and make python3-docs as your first package :)
Else, you can just take python-docs specfile from dist-git [2] and modify it, it shouldn't be that hard.

[1] https://fedoraproject.org/wiki/Join_the_package_collection_maintainers?rd=PackageMaintainers/Join
[2] http://pkgs.fedoraproject.org/cgit/python-docs.git

Comment 4 Fedora Update System 2013-10-22 12:28:34 UTC

python3-docs-3.3.2-2.fc20 has been submitted as an update for Fedora 20.
https://admin.fedoraproject.org/updates/python3-docs-3.3.2-2.fc20

Comment 5 Fedora Update System 2013-10-22 18:51:52 UTC

python3-docs-3.3.2-2.fc20 has been pushed to the Fedora 20 testing repository.

Comment 6 Fedora Update System 2013-11-10 07:58:33 UTC

python3-docs-3.3.2-2.fc20 has been pushed to the Fedora 20 stable repository.