doc Add link to list definition in Glossary list entry

[andresdelfino]

BPO	33869
Nosy	@freddrake, @rhettinger, @methane, @andresdelfino
PRs	bpo-33869: Add link to list definition in Glossary list entry #7706

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2018-07-19.13:31:40.269>
created_at = <Date 2018-06-15.14:43:21.736>
labels = ['3.8', 'type-feature', '3.7', 'docs']
title = 'doc Add link to list definition in Glossary list entry'
updated_at = <Date 2018-07-19.13:31:40.268>
user = 'https://github.com/andresdelfino'

bugs.python.org fields:

activity = <Date 2018-07-19.13:31:40.268>
actor = 'adelfino'
assignee = 'docs@python'
closed = True
closed_date = <Date 2018-07-19.13:31:40.269>
closer = 'adelfino'
components = ['Documentation']
creation = <Date 2018-06-15.14:43:21.736>
creator = 'adelfino'
dependencies = []
files = []
hgrepos = []
issue_num = 33869
keywords = ['patch']
message_count = 5.0
messages = ['319619', '319673', '319676', '319849', '319852']
nosy_count = 5.0
nosy_names = ['fdrake', 'rhettinger', 'methane', 'docs@python', 'adelfino']
pr_nums = ['7706']
priority = 'normal'
resolution = 'rejected'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue33869'
versions = ['Python 2.7', 'Python 3.6', 'Python 3.7', 'Python 3.8']

[andresdelfino]

PR adds entries for these three terms and a link to the list definition.

[rhettinger]

This probably shouldn't be done. It is not the goal of the glossary to define all built-in types. We have other sections of the documentation for that purpose. Also, there is no demonstrated need.

[andresdelfino]

I thought since dictionary and list is there, tuple/set/frozenset should be, too. But I think you are right.

I'd keep the link to the list definition, though. I didn't add a link to the dictionary definition as "dictionary" seems to be a very open term.

[methane]

Andrés, you seems making pull request to document at very high pace.

First of all, thank you for trying improving document.

But some of your pull request seems very little benefit for most readers. Your motivation seems consistency than real people.

In PEP-8, "A Foolish Consistency is the Hobgoblin of Little Minds" is top of the rules. I think it is same to documentation.

Random many small changes to document will consume core-dev's time and reduce translation coverage.

Please stop thinking like "Because X is ~, Y should be ~".
Instead, please think about helping real world people.

Regards,

[andresdelfino]

Sorry, INADA, you are right.