Mailman 3 August 2017 - docs

Last version of Zip archive is August 10th
by Mikhail Domanov 18 Aug '17

18 Aug '17

Hello Python Docs, I would like to leave a short message in case this is a bug. If I open page https://docs.python.org/3/download.html I see "Last updated on: Aug 18, 2017." But if I download the archive on this same page https://docs.python.org/3/archives/python-3.6.2-docs-html.zip and inside this archive I open >> python-3.6.2-docs-html/download.html I see "Last updated on: Aug 10, 2017." In fact this zip file has not been updated since August, 10th. Besides, I would like to take this opportunity to thank you for such a great product! It saved me tons of hours on routine tasks. С уважением (kind regards), Mikhail Domanov Saturday, August 19, 2017 mailto:Mikhail.Domanov@gmail.com skype: domanov.mikhail

1 0

[issue31224] Missing definition of frozen module
by Marco Buttu 17 Aug '17

17 Aug '17

New submission from Marco Buttu: In the doc there are several hints [*] to frozen modules, but there is no definition of them. Do you think we should add a "frozen module" definition to the glossary? * Doc/library/importlib.rst, Doc/library/imp.rst, Doc/reference/import.rst, ... ---------- assignee: docs@python components: Documentation messages: 300405 nosy: docs@python, marco.buttu priority: normal severity: normal status: open title: Missing definition of frozen module type: enhancement versions: Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31224> _______________________________________

1 0

Improve presentation style Python Docs
by Jan 16 Aug '17

16 Aug '17

Would it be possible to change the presentation style of the Python documentation, so readability and discovery of information is improved (especially for new users). This could be achieved by using standardised sections for each module/class page, making use of HTML tables to structure information (for example the available functions), and better use of white space to aid overview and discovery. The documentation currently sometimes 'feels' like a big blob of text. Pages can be perceived as long and unstructured, especially if you're a new user who's not very familiar with the language yet. https://docs.python.org/3/library/string.html Example of C# documentation page https://msdn.microsoft.com/en-us/library/system.string(v=vs.110).aspx (just an example for inspiration purposes)

1 0

https://www.python.org/ftp/python/doc/3.4.7rc1/python-3.4.7rc1-docs-pdf-letter.zip 404 Not Found
by Alvin Quiring 15 Aug '17

15 Aug '17

Python.org The above download file response returns 404 Not Found. Please fix. Alvin

1 0

[issue31024] typing.Tuple is class but is defined as data inside https://docs.python.org/3.6/objects.inv
by Ivan Levkivskyi 14 Aug '17

14 Aug '17

Ivan Levkivskyi added the comment: Bernát, I would recommend asking this on Sphinx tracker (I also assigned this to docs@python since this seems to be a purely documentation issue). https://github.com/sphinx-doc/sphinx ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python type: -> enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31024> _______________________________________

1 0

[issue31191] Fix grammar in threading.Barrier docs
by Mariatta Wijaya 14 Aug '17

14 Aug '17

Changes by Mariatta Wijaya <mariatta.wijaya(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31191> _______________________________________

1 0

Modules section Bug
by Pratik B. Surani 14 Aug '17

14 Aug '17

Hi, I could see a bug in the Modules section page of Tutorial https://docs.python.org/3/tutorial/modules.html Below are the modules in Fibo.py # Fibonacci numbers module def fib(n): # write Fibonacci series up to n a, b = 0, 1 while b < n: print(b, end=' ') a, b = b, a+b print() def fib2(n): # return Fibonacci series up to n result = [] a, b = 0, 1 while b < n: result.append(b) a, b = b, a+b return result The problem is with the below section: Fib2(100) doesn't print the data, it just returns the data. So it will first have to be assigned to a variable and then can print that variable. >>> fibo.fib(1000) 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 >>> fibo.fib2(100) [1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89] >>> fibo.__name__ 'fibo' Regards, Pratik Surani 07565987160

1 0

[issue31201] module test that failed doesn't exist
by R. David Murray 14 Aug '17

14 Aug '17

R. David Murray added the comment: Yep, I figured that. That's why I suggested the clarification to the README, if someone wants to generate a PR for it. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31201> _______________________________________

1 0

[issue31201] module test that failed doesn't exist
by Paulo Matos 14 Aug '17

14 Aug '17

Paulo Matos added the comment: Argh, apologies David. I hadn't noticed the mistake. I simply copy/pasted and was expecting the command line to rerun all the tests that had previously failed. I was assuming the suite had some kind of state that recorded the tests that previously failed and ran only those. :) ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31201> _______________________________________

1 0

[issue31201] module test that failed doesn't exist
by R. David Murray 14 Aug '17

14 Aug '17

R. David Murray added the comment: Replace "test_that_failed" with the name of the test that failed. The README could be improved by saying: If any tests fail, you can re-run the failing test(s) in verbose mode. For example if, 'test_os' and 'test_gdb' failed, you can run:: make test TESTOPTS="-v test_os test_gdb" ---------- assignee: -> docs@python components: +Documentation -Tests nosy: +docs@python, r.david.murray _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue31201> _______________________________________

1 0