New submission from Thomas Cavalli <thomaspcava...@gmail.com>:

The Division (/) section example uses the commented variable "result" without 
it being defined.  I am counting 4 numbers, (5.6667, 5, 2, 17), that are called 
result. The correct result can be implied but its poor documentation. So, 
either change:
>>> 17 // 3   # floor division discards the fractional part
to
>>> result = 17 // 3   # floor division discards the fractional part

or change:
>>> 5 * 3 + 2   # result * divisor + remainder
to
>>> 5 * 3 + 2  # floor * divisor + remainder

I suggest the latter as it explains the formula for floor.

----------
assignee: docs@python
components: Documentation
messages: 390217
nosy: docs@python, thomaspcavalli
priority: normal
severity: normal
status: open
title: Tutorial Documentation for 3.1.1. Numbers missing "result"
type: enhancement
versions: Python 3.9

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue43729>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to