diff -r b5824266af5a pep-0008.txt --- a/pep-0008.txt Thu Feb 18 07:02:27 2016 -0500 +++ b/pep-0008.txt Mon Feb 22 18:49:51 2016 +0530 @@ -42,10 +42,10 @@ A style guide is about consistency. Consistency with this style guide is important. Consistency within a project is more important. -Consistency within one module or function is most important. +Consistency within one module or function is the most important thing. -But most importantly: know when to be inconsistent -- sometimes the -style guide just doesn't apply. When in doubt, use your best +But more importantly: know when to be inconsistent -- sometimes the +style guide just isn't applicable. When in doubt, use your best judgment. Look at other examples and decide what looks best. And don't hesitate to ask! @@ -79,7 +79,7 @@ Continuation lines should align wrapped elements either vertically using Python's implicit line joining inside parentheses, brackets and braces, or using a *hanging indent* [#fn-hi]_. When using a hanging -indent the following considerations should be applied; there should be +indent the following should be considered; there should be no arguments on the first line and further indentation should be used to clearly distinguish itself as a continuation line. @@ -1231,8 +1231,8 @@ Yes: if not seq: if seq: - No: if len(seq) - if not len(seq) + No: if len(seq): + if not len(seq): - Don't write string literals that rely on significant trailing whitespace. Such trailing whitespace is visually indistinguishable @@ -1286,7 +1286,7 @@ PEP 484 recommends the use of stub files: .pyi files that are read by the type checker in preference of the corresponding .py files. Stub files can be distributed with a library, or separately (with - the library author's permission) through the typeshed repo [5]_. + the library author's permission) through the typeshed repo [4]_. - For code that needs to be backwards compatible, function annotations can be added in the form of comments. Basically, this Python 3 annotation:: @@ -1302,7 +1302,7 @@ """Embezzle funds from account using fake receipts.""" - The mypy type checker [6]_ currently supports this syntax, and other + The mypy type checker [5]_ currently supports this syntax, and other type checkers are encouraged to adopt it. @@ -1326,13 +1326,10 @@ .. [3] http://www.wikipedia.com/wiki/CamelCase -.. [4] PEP 8 modernisation, July 2013 - http://bugs.python.org/issue18472 - -.. [5] Typeshed repo +.. [4] Typeshed repo https://github.com/python/typeshed -.. [6] mypy type checker +.. [5] mypy type checker http://mypy-lang.org https://github.com/JukkaL/mypy