diff options
author | Aeros <44193521+aeros167@users.noreply.github.com> | 2019-06-21 04:43:07 (GMT) |
---|---|---|
committer | Carol Willing <carolcode@willingconsulting.com> | 2019-06-21 04:43:07 (GMT) |
commit | d0068000b266e9b7b0178e3d0640cceda5f3c7fb (patch) | |
tree | b8968a9de3be03f712913b10e912df6f661e65af /Doc/faq | |
parent | b9600b0fbd71908f9fb3dd1bf78ebba6c4a16115 (diff) | |
download | cpython-d0068000b266e9b7b0178e3d0640cceda5f3c7fb.zip cpython-d0068000b266e9b7b0178e3d0640cceda5f3c7fb.tar.gz cpython-d0068000b266e9b7b0178e3d0640cceda5f3c7fb.tar.bz2 |
Docs: Improved phrasing (GH-14069)
* Docs: Improved phrasing
Removed usage of second person pronouns in the section and made the assumption of "uneasiness" in code style transition more neutral.
* Removed trailing whitespace on line 34
Diffstat (limited to 'Doc/faq')
-rw-r--r-- | Doc/faq/design.rst | 10 |
1 files changed, 6 insertions, 4 deletions
diff --git a/Doc/faq/design.rst b/Doc/faq/design.rst index e2d63a0..387420c 100644 --- a/Doc/faq/design.rst +++ b/Doc/faq/design.rst @@ -24,14 +24,16 @@ programmers will encounter a fragment of code like this:: z++; Only the ``x++`` statement is executed if the condition is true, but the -indentation leads you to believe otherwise. Even experienced C programmers will -sometimes stare at it a long time wondering why ``y`` is being decremented even +indentation leads many to believe otherwise. Even experienced C programmers will +sometimes stare at it a long time wondering as to why ``y`` is being decremented even for ``x > y``. Because there are no begin/end brackets, Python is much less prone to coding-style conflicts. In C there are many different ways to place the braces. -If you're used to reading and writing code that uses one style, you will feel at -least slightly uneasy when reading (or being required to write) another style. +After becoming used to reading and writing code using a particular style, +it is normal to feel somewhat uneasy when reading (or being required to write) +in a different one. + Many coding styles place begin/end brackets on a line by themselves. This makes programs considerably longer and wastes valuable screen space, making it harder |