[issue15439] Include Misc/ACKS names into the documentation

Changes by Ezio Melotti : -- assignee: docs@python -> ezio.melotti resolution: -> fixed stage: needs patch -> committed/rejected status: open -> closed type: -> enhancement versions: +Python 2.7, Python 3.2, Python 3.3 ___ Python tracker

[issue15439] Include Misc/ACKS names into the documentation

Roundup Robot added the comment: New changeset 48185b0f7b8a by Ezio Melotti in branch '3.2': #15437, #15439: merge Doc/ACKS.txt with Misc/ACKS and modify Doc/about.rst accordingly. http://hg.python.org/cpython/rev/48185b0f7b8a New changeset 2b4a89f82485 by Ezio Melotti in branch 'default': #154

[issue15439] Include Misc/ACKS names into the documentation

Terry J. Reedy added the comment: I agree with Martin also. A short paragraph and link to the (combined) online file is quite sufficient. There is no need for the file to be in offline copies. And I would make the change in all current versions. -- nosy: +terry.reedy

[issue15439] Include Misc/ACKS names into the documentation

Antoine Pitrou added the comment: > OK, I propose to completely drop the Doc/ACKS.txt from the documentation, and > replace it with the words Sounds good to me. -- ___ Python tracker

[issue15439] Include Misc/ACKS names into the documentation

Changes by Tshepang Lekhonkhobe : -- nosy: +tshepang ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mai

[issue15439] Include Misc/ACKS names into the documentation

Martin v. Löwis added the comment: OK, I propose to completely drop the Doc/ACKS.txt from the documentation, and replace it with the words "Many people have contributed to the Python language, the Python standard library, and the Python documentation. See Misc/ACKS in the Python source distr

[issue15439] Include Misc/ACKS names into the documentation

Ezio Melotti added the comment: FWIW including Misc/ACKS in the doc will probably break the generation of the pdf version of the doc, since it contains non-latin1 characters (see msg166408). I don't think it's necessary to include the names in the doc. > I don't know how Doc ACKS is maintain

[issue15439] Include Misc/ACKS names into the documentation

Martin v. Löwis added the comment: I don't know how Doc ACKS is maintained, but I think the devguide is fine as it stands, whether or not Doc ACKS is preserved or not. People should put themselves into Misc/ACKS if they made a contribution, period. If people need to be acknowledged separately

[issue15439] Include Misc/ACKS names into the documentation

Chris Jerdonek added the comment: Okay, thanks for clarifying. Then I have no strong opinion. However, if Doc/ACKS.txt is retained, then I think the Dev Guide should mention Doc/ACKS.txt just as it mentions Misc/ACKS: http://docs.python.org/devguide/patch.html#preparation And it should incl

[issue15439] Include Misc/ACKS names into the documentation

Meador Inge added the comment: What I meant by that was that Serhiy contributed a code change and was already in Misc/ACKS, therefore no ACKS file should have been updated. I didn't mean to imply that someone can't be in both files. My impression is that Misc/ACKS is for code contributions

[issue15439] Include Misc/ACKS names into the documentation

Chris Jerdonek added the comment: Is that a -0 then, Raymond? I think either the combined Misc/ACKS list should be included in the docs, or it should be removed entirely. If what Meador said is true (that people already in Misc/ACKS who contribute documentation should not be added)-- > Doc/

[issue15439] Include Misc/ACKS names into the documentation

Raymond Hettinger added the comment: I agree with Martin and don't think the ACKS list should be exposed further than it already is. -- nosy: +rhettinger ___ Python tracker ___

[issue15439] Include Misc/ACKS names into the documentation

Martin v. Löwis added the comment: I think Guido's wording should be included literally in the online version. It very much explains what this list really is and how to interpret it. The post scriptum should be converted into a ReST comment, since it is primarily a note to maintainers. -

[issue15439] Include Misc/ACKS names into the documentation

Chris Jerdonek added the comment: The second sense of the word "include" is in the possible implementation. Éric pointed out in the other issue's thread that this can be achieved by modifying the existing include directive, for example-- --- a/Doc/about.rst +++ b/Doc/about.rst @@ -30,7 +30,7

[issue15439] Include Misc/ACKS names into the documentation

Martin v. Löwis added the comment: I see; I'm changing my vote to -0 then. I don't think this list of names should have been included in the documentation in the first place. Since it is, providing the full list of contributors is just as fine. --

[issue15439] Include Misc/ACKS names into the documentation

Serhiy Storchaka added the comment: > Ok, please rephrase: what do you mean by "inlude ... into ..."? http://docs.python.org/about.html#contributors-to-the-python-documentation -- nosy: +storchaka ___ Python tracker

[issue15439] Include Misc/ACKS names into the documentation

Martin v. Löwis added the comment: Ok, please rephrase: what do you mean by "inlude ... into ..."? If the place of Misc/ACKS doesn't change, in what way is it being included into something? And which "documentation" is it being included into, if it doesn't change its location? -- __

[issue15439] Include Misc/ACKS names into the documentation

Chris Jerdonek added the comment: Martin, just to be sure, this is to be done after issue 15437 (a dependency), and the location of Misc/ACKS will not change. Have you already read the discussion there? Éric said that he recalled it was Georg's preference to do this if Doc/ACKS.txt is remov

[issue15439] Include Misc/ACKS names into the documentation

Martin v. Löwis added the comment: -1. Misc/ACKS is fine where it is. No need to include it into the docs. -- nosy: +loewis ___ Python tracker ___ __

[issue15439] Include Misc/ACKS names into the documentation

Changes by Chris Jerdonek : -- dependencies: +Merge Doc/ACKS and Misc/ACKS ___ Python tracker ___ ___ Python-bugs-list mailing list Un

[issue15439] Include Misc/ACKS names into the documentation

New submission from Chris Jerdonek : This issue is to include the names in Misc/ACKS into the documentation -- in place of the names from Doc/ACKS.txt. This was mentioned in the discussion for issue 15437, which is to add the names from Doc/ACKS.txt into Misc/ACKS. This issue should be done sho