From 9cc8e94c1efa092577b734fdc6d49ad5bc5501ed Mon Sep 17 00:00:00 2001 From: Aeros <44193521+aeros167@users.noreply.github.com> Date: Thu, 13 Jun 2019 22:55:12 -0400 Subject: [PATCH 1/2] Docs: Improved phrasing Removed usage of second person pronouns in the section and made the assumption of "uneasiness" in code style transition more neutral. --- Doc/faq/design.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/Doc/faq/design.rst b/Doc/faq/design.rst index e2d63a0323da66..2661306b336407 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 From 0ef0a343bba43acfeb87216d8d4e9f42e07932cf Mon Sep 17 00:00:00 2001 From: Aeros <44193521+aeros167@users.noreply.github.com> Date: Thu, 20 Jun 2019 22:43:09 -0400 Subject: [PATCH 2/2] Removed trailing whitespace on line 34 --- Doc/faq/design.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/faq/design.rst b/Doc/faq/design.rst index 2661306b336407..387420c17bd152 100644 --- a/Doc/faq/design.rst +++ b/Doc/faq/design.rst @@ -31,7 +31,7 @@ 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. 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) +it is normal to feel somewhat uneasy when reading (or being required to write) in a different one.