This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author vstinner
Recipients benjamin.peterson, georg.brandl, ned.deily, paul.moore, steve.dower, tim.golden, vstinner, zach.ware
Date 2017-02-16.13:41:31
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <CAMpsgwZHrgm1eiUv0GMtcq_DBdMYeEnMvRLh263jcCKmLFS0Rg@mail.gmail.com>
In-reply-to <1487251926.21.0.263467038534.issue29579@psf.upfronthosting.co.za>
Content
Another option (don't know if it's a good idea or not) is to not
include any README file in the installer. Is it really worth it? Why
not pointing to docs.python.org/3.7/ for example? Or suggest to
install the "Windows help file" package?

I just checked on my Fedora 25: the python3 package includes
/usr/share/doc/python3/README file.

I also checked if any other package include .rst doc: I found a lot of
them. As you may expect, most Python packages.

But for example, the "dnf" system tool used to manage packages only
uses a README.rst file which even includes a reference to an external
image:
https://raw.githubusercontent.com/rpm-software-management/dnf/gh-pages/logos/DNF_logo.png

You can find dnf README file at:
https://github.com/rpm-software-management/dnf/blob/master/README.rst

Other examples of packages including reST doc (excluding python*):
devassistant, koji, vex, fpaste, pypy, git-review, hawkey, subunit,
libbytesize, etc.

Ah just to be clear: Fedora packages provide reST as plain text, .rst
files, not HTML.
History
Date User Action Args
2017-02-16 13:41:31vstinnersetrecipients: + vstinner, georg.brandl, paul.moore, tim.golden, benjamin.peterson, ned.deily, zach.ware, steve.dower
2017-02-16 13:41:31vstinnerlinkissue29579 messages
2017-02-16 13:41:31vstinnercreate