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 Abraham.Smith
Recipients Abraham.Smith, docs@python, georg.brandl, steven.daprano
Date 2015-02-07.13:37:05
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1423316226.64.0.0375582141005.issue23406@psf.upfronthosting.co.za>
In-reply-to
Content
Thanks for the helpful responses and correcting my misunderstanding.

Regarding improved documentation, I see now that the table at https://docs.python.org/2/library/stdtypes.html#id2 indeed says "shallow copies"; however, the footnote seems to bury the lede.   Perhaps the footnote should be expanded to either link to the FAQ entry or provide an abbreviated version of it.

The FAQ entry is actually very good, but I would guess that most readers (like me) skip the FAQs and jump straight to the library reference.    Internet users have been trained for 20 years to believe that FAQs are full of useless, snarky answers to questions at a much shallower level, like "what do I do with a .tar.gz file?".  The fact that Python's FAQ is extremely well-written and helpful is a pleasant surprise, but a surprise none-the-less.
History
Date User Action Args
2015-02-07 13:37:06Abraham.Smithsetrecipients: + Abraham.Smith, georg.brandl, steven.daprano, docs@python
2015-02-07 13:37:06Abraham.Smithsetmessageid: <1423316226.64.0.0375582141005.issue23406@psf.upfronthosting.co.za>
2015-02-07 13:37:06Abraham.Smithlinkissue23406 messages
2015-02-07 13:37:05Abraham.Smithcreate