kennethreitz/python-guide
1
0
Fork 0
mirror of https://github.com/kennethreitz/python-guide.git synced 2026-06-05 06:46:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #183 from thomasballinger/spelling-fix

Browse Source 
Spelling fixes in style guide
This commit is contained in:
Kenneth Reitz
2012-07-28 13:58:20 -07:00
parent 3cdb586d70 a8e36af3ea
commit dc3af98a38
1 changed files with 5 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/writing/style.rst
+5 -5
View File
@@ -9,7 +9,7 @@ recognised fact that code is read much more often than it is written.
One reason for Python code to be easily read and understood is its relatively
complete set of Code Style guidelines and "Pythonic" idioms.
Moreover, when a veteran Python developer (a Pythonistas) point to some
Moreover, when a veteran Python developer (a Pythonista) point to some
parts of a code and say it is not "Pythonic", it usually means that these lines
of code do not follow the common guidelines and fail to express the intent in
what is considered the best (hear: most readable) way.
@@ -128,7 +128,7 @@ called with each recipient as an argument: ``send('Hello', 'God', 'Mom',
'Cthulhu')``, and in the function body ``args`` will be equal to ``('God',
'Mom', 'Cthulhu')``.
However, this construct has some drawback and should be used with caution. If a
However, this construct has some drawbacks and should be used with caution. If a
function receives a list of arguments of the same nature, it is often more
clear to define it as a function of one argument, that argument being a list or
any sequence. Here, if ``send`` has multiple recipients, it is better to define
@@ -156,7 +156,7 @@ Python functions that are:
* easy to read (the name and arguments need no explanations)
* easy to change (adding a new keyword argument do not break other parts of the
* easy to change (adding a new keyword argument does not break other parts of the
code)
Avoid the magical wand
@@ -178,8 +178,8 @@ possibilities, because it grows the confidence that no hard-wall will be on the
way. However, knowing how to use them and particularly when **not** to use
them is the most important.
Like a Kungfu master, a pythonistas knows how to kill with a single finger, and
never do it.
Like a Kungfu master, a Pythonista knows how to kill with a single finger, and
never to do it.
We are all consenting adults
~~~~~~~~~~~~~~~~~~~~~~~~~~~~