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 bgailer
Recipients bgailer, docs@python
Date 2014-04-25.20:27:38
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1398457661.12.0.679738685491.issue21352@psf.upfronthosting.co.za>
In-reply-to
Content
Inconsistencies / confusion with documentation Index Tab. Example (line numbers added for comments that follow):

1 max
2   built-in function
3 max  (datetime.date attribute)
4   (datetime.datetime attribute)
5   (datetime.time attribute)
6 max() built-in function
7   (decimal.Context method)
8   (decimal.Decimal method)
9   (in module audioloop)

The following all lead to confusion and frustration:
Having 3 rows (1, 3, 6)that begin with max. 
Having an entry (1) that does nothing when double-clicked.
double-clicking (2) takes us to a reference rather than a definition.

RECOMMENDATION:
change to:
max() built-in function
  (sequence operation)
  (decimal.Context method)
  (decimal.Decimal method)
max
  (datetime.date attribute)
  (datetime.datetime attribute)
  (datetime.time attribute)

where double-clicking the first line goes to the max() definition
in 2. Built-in Functions


These comments apply, with a number of variations, to most built-in functions index entries.
History
Date User Action Args
2014-04-25 20:27:41bgailersetrecipients: + bgailer, docs@python
2014-04-25 20:27:41bgailersetmessageid: <1398457661.12.0.679738685491.issue21352@psf.upfronthosting.co.za>
2014-04-25 20:27:40bgailerlinkissue21352 messages
2014-04-25 20:27:38bgailercreate