docs patch: dicts and sets

[Steve Holden]

7stud wrote:
> On May 19, 9:06 am, Steven Bethard <steven.beth... at gmail.com> wrote:
>> Alan Isaac wrote:
>>> I submitted the language based on Bill and Carsten's proposals:
>>> https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1721372&...
>>> That language has been rejected.
>>> You many want to read the discussion and see if
>>> acceptible language still seems discoverable.
>> Seems to me that you're focusing on the wrong part of the docs.  The
>> source of this "bug" is not sets or dicts, but the default __hash__
>> method implementation.  Why don't you propose adding something like:
>>
>>      The default __hash__ method is based on an object's id(), and can
>>      therefore change between different iterations of the same program.
>>
>> to the docs for __hash__:
>>
>>      http://docs.python.org/ref/customization.html
>>
>> Then if you really feel you need to add something for sets and dicts,
>> you can add a cross-reference to the __hash__ docs.
>>
>> STeVe
> 
> 
> Here's an idea--add All the proposed changes to the docs.  Why not
> allow user's to add any explanations to the docs that they want? Then
> readers can choose the explanations that make the most sense to them.
> It would eliminate endless, petty discussions about what minutiae are
> more important, and it would allow people to spend their time on more
> productive efforts.  And it would improve the docs exponentially.
> 
Except in those instances where users added information that was 
explicitly wrong. Which any reader of this newsgroup knows is all too 
easy to do. So there would need to be some editorial control. Which 
would take effort that may not currently be available.

regards
  Steve
-- 
Steve Holden        +1 571 484 6266   +1 800 494 3119
Holden Web LLC/Ltd           http://www.holdenweb.com
Skype: holdenweb      http://del.icio.us/steve.holden
------------------ Asciimercial ---------------------
Get on the web: Blog, lens and tag your way to fame!!
holdenweb.blogspot.com        squidoo.com/pythonology
tagged items:         del.icio.us/steve.holden/python
All these services currently offer free registration!
-------------- Thank You for Reading ----------------