Skip to content

Commit 7c21a38

Browse files
authored
Merge pull request realpython#716 from kikisdeliveryservice/master
Clean up of intro paragraphs for clarity.
2 parents 856ebde + 2ed32eb commit 7c21a38

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

docs/writing/style.rst

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,17 +3,17 @@
33
Code Style
44
==========
55

6-
If you ask Python programmers what they like most in Python, they will
7-
often say its high readability. Indeed, a high level of readability
6+
If you ask Python programmers what they like most about Python, they will
7+
often cite its high readability. Indeed, a high level of readability
88
is at the heart of the design of the Python language, following the
99
recognized fact that code is read much more often than it is written.
1010

11-
One reason for Python code to be easily read and understood is its relatively
11+
One reason for the high readability of Python code is its relatively
1212
complete set of Code Style guidelines and "Pythonic" idioms.
1313

14-
Moreover, when a veteran Python developer (a Pythonista) points to portions of
15-
code and says they are not "Pythonic", it usually means that these lines
16-
of code do not follow the common guidelines and fail to express the intent in
14+
When a veteran Python developer (a Pythonista) calls portions of
15+
code not "Pythonic", they usually mean that these lines
16+
of code do not follow the common guidelines and fail to express its intent in
1717
what is considered the best (hear: most readable) way.
1818

1919
On some border cases, no best way has been agreed upon on how to express
@@ -53,7 +53,7 @@ One statement per line
5353

5454
While some compound statements such as list comprehensions are
5555
allowed and appreciated for their brevity and their expressiveness,
56-
it is bad practice to have two disjoint statements on the same line of code.
56+
it is bad practice to have two disjointed statements on the same line of code.
5757

5858
**Bad**
5959

0 commit comments

Comments
 (0)