[docs] [issue21484] More clarity needed about difference between "x += e" and "x = x + e"

[Feliks]

Feliks added the comment:

Well, there is some anecdotal evidence. ;-)  I happen to have a lot of experience with a lot of programming languages, and I was bitten by this.

Let's put it like this: it is quite easy to overlook the significance of the sentence in question.  One looks at the paragraph, reads the stuff about evaluation, thinks "of course" and moves on.

If the sentence were in a new paragraph, and instead of with "Also" began with something like "More importantly", then it might have drawn more attention.

After all, the drastic semantic difference between the two forms is quite unlike what one is used to from programming in, say, C.  I think it would be helpful if it were stressed a little bit more.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21484>
_______________________________________