classification
Title: Add the term "dunder" to the glossary
Type: enhancement Stage: needs patch
Components: Documentation Versions: Python 3.7, Python 3.6, Python 2.7
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: fdrake Nosy List: Mariatta, barry, brett.cannon, docs@python, fdrake, pitrou, rhettinger, serhiy.storchaka
Priority: normal Keywords: easy

Created on 2017-11-03 20:57 by brett.cannon, last changed 2017-11-09 09:00 by rhettinger.

Messages (10)
msg305509 - (view) Author: Brett Cannon (brett.cannon) * (Python committer) Date: 2017-11-03 20:57
The term "dunder" is used out in the community regularly, but if you have never been exposed to it before it can seem a little odd without context.
msg305510 - (view) Author: Barry A. Warsaw (barry) * (Python committer) Date: 2017-11-03 20:59
-1 until we have something we can call a "mifflin".

(Kidding of course!)
msg305512 - (view) Author: Mariatta Wijaya (Mariatta) * (Python committer) Date: 2017-11-03 21:02
> until we have something we can call a "mifflin".

Name of next GitHub bot? :P
msg305513 - (view) Author: Mariatta Wijaya (Mariatta) * (Python committer) Date: 2017-11-03 21:03
Anyway, +1 to adding dunder to glossary.
msg305542 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2017-11-04 08:41
I think it shouldn't be added as a separate entry, but just mentioned in [1] and [2], and added to the index.

[1] https://docs.python.org/3/glossary.html#term-special-method
[2] https://docs.python.org/3/reference/datamodel.html#specialnames
msg305569 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2017-11-04 21:52
I would rather not clutter the glossary with this sort of entry.  Already, it has clutter that should probably be removed so that once again it becomes a worthwhile read rather than turning into a dictionary of random terms (such as meta-path-finder, module spec, and regular-package).

Instead, there should probably be a FAQ entry or wiki entry on the ever evolving spoken cultural terminology:

   dunder --> double underscore
   stir   --> __str__
   repper --> __repr__
   rest --> .rst files or representational-state-transfer
   sequel -> sql
   gwid -> globally unique indentifier
   inker and decker -> incref and decef    (larry hastings pronunciation)
msg305786 - (view) Author: Mariatta Wijaya (Mariatta) * (Python committer) Date: 2017-11-07 17:28
Thanks Raymond. +1 for adding the above list. 

I don't think FAQ is the right place either, I prefer we don't have to add the entries in the form of questions & answers.
msg305791 - (view) Author: Antoine Pitrou (pitrou) * (Python committer) Date: 2017-11-07 20:18
Agreed with Raymond that Python folk terminology should not go into the glossary.  I don't think I ever say "dunder" myself.
msg305792 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2017-11-07 20:56
I never seen terms like "stir" or "inker", but the term "dunder" is used pretty widely. The glossary already contains abbreviations and Python folk terminology like EAFP and BDFL.
msg305946 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2017-11-09 09:00
Recommend closing this and leaving it for StackOverflow.  I really don't want to further garbage-up the glossary.
History
Date User Action Args
2017-11-09 09:00:53rhettingersetmessages: + msg305946
2017-11-09 08:59:31rhettingersetassignee: docs@python -> fdrake

nosy: + fdrake
2017-11-07 20:56:52serhiy.storchakasetmessages: + msg305792
2017-11-07 20:18:31pitrousetnosy: + pitrou
messages: + msg305791
2017-11-07 17:28:52Mariattasetmessages: + msg305786
2017-11-04 21:52:59rhettingersetnosy: + rhettinger
messages: + msg305569
2017-11-04 08:41:21serhiy.storchakasettype: enhancement
versions: + Python 2.7, Python 3.6, Python 3.7
keywords: + easy
nosy: + serhiy.storchaka

messages: + msg305542
stage: needs patch
2017-11-03 21:03:36Mariattasetmessages: + msg305513
2017-11-03 21:02:03Mariattasetnosy: + Mariatta
messages: + msg305512
2017-11-03 20:59:17barrysetnosy: + barry
messages: + msg305510
2017-11-03 20:57:49brett.cannoncreate