diff --git a/docs/writing/style.rst b/docs/writing/style.rst index 919d3a147..41fac9b37 100644 --- a/docs/writing/style.rst +++ b/docs/writing/style.rst @@ -251,7 +251,16 @@ is a probable indication that such a refactoring is needed. Idioms ------ -Idiomatic Python code is often referred to as being *Pythonic*. +A programming Idiom, put simply, is _a way_ to write code. The notion of programming Idioms +is discussed amply at `c2 ` and at `Stack Overflow `. + +Idiomatic Python code is often referred to as being *Pythonic*. + +Although there usually is one-- and preferably only one --obvious way to do it; +_the_ way to write idiomatic Python code can be non-obvious to Python beginners. So, +good idioms must be consciously acquired. + +Some common Python idioms follow: .. _unpacking-ref: