[issue28820] Typo in section 6 of the Python 3.4 documentation
New submission from Rares Aioanei: In section 6.4.1. it's said "Although certain modules are designed to export only names that follow certain patterns when you use import *, it is still considered bad practise in production code." "practise" should be "practice", as it's a noun. ---------- assignee: docs@python components: Documentation messages: 281870 nosy: Rares Aioanei, docs@python priority: normal severity: normal status: open title: Typo in section 6 of the Python 3.4 documentation type: enhancement versions: Python 3.4 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
Julien Palard added the comment: Hi Rares thanks for reporting. While building a patch for this issue I found another occurrence of the error. ---------- keywords: +patch nosy: +mdk Added file: http://bugs.python.org/file45672/issue28820.diff _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
Martin Panter added the comment: Thanks, this looks good to me, although let’s not touch the blank line at the end of the file. ---------- nosy: +martin.panter stage: -> commit review versions: +Python 2.7, Python 3.5, Python 3.6, Python 3.7 -Python 3.4 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
Julien Palard added the comment: Hi Martin, Removed the removing of the double new line at end of file. ---------- Added file: http://bugs.python.org/file45686/issue28820-2.diff _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
Josh Rosenberg added the comment: Just OOC, what version of English are the docs supposed to use? In American English, noun vs. verb doesn't matter, it's always "practice" (there is no such word as "practise"). In this case it doesn't matter (it's a noun, and everyone agrees on the spelling), but is there a defined standard? ---------- nosy: +josh.r _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
R. David Murray added the comment: We at least used to point to Apple's style guide. I'm not sure where we point at the moment (it's in the documentation somewhere :). But yes, it's pretty much formal American English, though I'm sure there are places where other spelling has crept in. ---------- nosy: +r.david.murray _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
Roundup Robot added the comment: New changeset 4f24641cd030 by Martin Panter in branch '2.7': Issue #28820: Fix spelling of “practice” as a noun https://hg.python.org/cpython/rev/4f24641cd030 ---------- nosy: +python-dev _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
Martin Panter added the comment: I’m waiting for the 3.6 release candidate before pushing to the Py 3 branches. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
Berker Peksag added the comment: Ned can correct me if I'm wrong, but you can push documentation patches without waiting for 3.6.0rc1. ---------- nosy: +berker.peksag _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
Ned Deily added the comment: Yes, there is no restriction on doc changes at the moment as long as they are relevant to 3.6.0. ---------- nosy: +ned.deily _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
Roundup Robot added the comment: New changeset 8e36c04d0e3e by Martin Panter in branch '3.5': Issue #28820: Fix spelling of “practice” as a noun https://hg.python.org/cpython/rev/8e36c04d0e3e New changeset e9b78a42e6c0 by Martin Panter in branch '3.6': Issue #28820: Merge spelling fixes from 3.5 https://hg.python.org/cpython/rev/e9b78a42e6c0 New changeset d786c620838c by Martin Panter in branch 'default': Issue #28820: Merge typo fixes from 3.6 https://hg.python.org/cpython/rev/d786c620838c ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
Changes by Martin Panter <vadmium+py@gmail.com>: ---------- resolution: -> fixed stage: commit review -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue28820> _______________________________________
participants (8)
-
Berker Peksag -
Josh Rosenberg -
Julien Palard -
Martin Panter -
Ned Deily -
R. David Murray -
Rares Aioanei -
Roundup Robot