Thanks for the feedback. I agree that these examples may not fit well in the idioms section. I wasn't exactly sure what the intent of the section was so I just tried those to see if @kennethreitz could give any guidance about what he expected.

I like the idea of having a recipe section to isolate best-practices given common problems.

When I think of idiomatic Python, I think of things that make sense in other languages which look "odd" in Python. A naive port of C (or PHP or Java or ...) code for a for loop might look like this:

things = ['one', 'two', 'three']
for i in range(len(things)):
    print things[i]

whereas idiomatic/Pythonic code would be simply:

for thing in things:
    print thing

Taking it a step further, suppose we also need access to the list indices:

for i, thing in enumerate(things):
    print i, thing

There are lots of other examples, I'm sure. A few others off the top of my head: list/tuple unpacking, and variable swaps (i.e. a, b = b, a); using in rather than has_key etc; defaultdict; list/set/dict comprehensions and generator expressions; as well as some more advanced examples like how to write decorators, how to write decorators that take arguments, and how to write decorators that optionally take arguments (I'm actually not sure how to do the third, but I suppose it's probably possible). This could grow to be a very long section, indeed, so some editorial effort may be required to document the most common or most important, and link to existing references for others.

I think this would work quite well in a performance section.

tbqh, I'm not sure where to go from here. Should I close the pull request and wait for for you to make a performance section?

I understand where you're coming from as far as moving this to a performance section. I'm new to making pull requests and how the direction of a project like this should progress. I'd like to know what your thoughts on moving forward are.

I'd suggest:

1. Rework this pull request into a Performance Tips section (which I don't think exists, so you'll have to add one)
2. If you want, do some research on sites on the internet listing Python idoms, pick those you think are most important, and add those to the Idomatic Python section (with links back to the source sites as necessary)

This is fantastic stuff. Sorry for the delay!