[issue37352] Typo in documentation: "to making it easy"

[Raymond Hettinger]

Change by Raymond Hettinger :


--
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions: +Python 3.9

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37352] Typo in documentation: "to making it easy"

[Raymond Hettinger]

Raymond Hettinger  added the comment:


New changeset a0f7119f1584db5b32deffb60a68d830673ebbdf by Raymond Hettinger 
(Ilya Kamenshchikov) in branch 'master':
bpo-37352: Minor word-smithing for design.rst (GH #14730)
https://github.com/python/cpython/commit/a0f7119f1584db5b32deffb60a68d830673ebbdf


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37352] Typo in documentation: "to making it easy"

[Ilya Kamenshchikov]

Ilya Kamenshchikov  added the comment:

The wording from Carol Willing makes it read simpler. Also in the next 
sentence, 'test-directed development' goes under the name 'test-driven 
development' as of 2019 (search in google -> 
https://en.wikipedia.org/wiki/Test-driven_development). I have created a pull 
request with simpler wording and 'test-driven development'.

CLA is signed, will take time to propagate.

--
nosy: +Ilya Kamenshchikov

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37352] Typo in documentation: "to making it easy"

[Ilya Kamenshchikov]

Change by Ilya Kamenshchikov :


--
keywords: +patch
pull_requests: +14525
stage:  -> patch review
pull_request: https://github.com/python/cpython/pull/14730

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37352] Typo in documentation: "to making it easy"

[Mark Rice]

Mark Rice  added the comment:

Hi, first time on here. And new to the python bug tracker. But, the sentence 
might read fine as is, or could be tweaked to say "with an eye toward making it 
easily tested..." as Zach suggested. It is what my internal grammar alarm 
jumped to automatically.

--
nosy: +mrice88

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37352] Typo in documentation: "to making it easy"

[Mariatta]

Mariatta  added the comment:

FWIW I agree that "with an eye to ..." sounds too complex. It would be great to 
change it to "with the goal of...".

--
nosy: +Mariatta

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37352] Typo in documentation: "to making it easy"

[Raymond Hettinger]

Raymond Hettinger  added the comment:

It reads fine to me as is.

--
nosy: +rhettinger

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37352] Typo in documentation: "to making it easy"

[YoSTEALTH]

YoSTEALTH  added the comment:

programmers "plan" their code, they don't "design" it, as far as i know!

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37352] Typo in documentation: "to making it easy"

[Carol Willing]

Carol Willing  added the comment:

I agree with Zach's suggestions.

If I were to rewrite and pass through a grammar checker, I would get closer to 
this (removing the verbose "an eye to":

Writing test suites is very helpful, and you might want to design your code to 
make it easily tested.

In other words, it is fine as is or with modifications. :-)

--
nosy: +willingc

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37352] Typo in documentation: "to making it easy"

[YoSTEALTH]

YoSTEALTH  added the comment:

"Writing test suites is very helpful, and you might want to plan your code 
based on expectation of making it easy for testing."

--
nosy: +YoSTEALTH

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37352] Typo in documentation: "to making it easy"

[Zachary Ware]

Zachary Ware  added the comment:

"making" looks fine to me as a native English speaker.  I'm not sure it's 
properly correct English, but it's fine colloquially and I don't think "make" 
would improve it :)

If anything, I'd change "to" to "toward", or possibly replace "an eye to" with 
"the goal of".

--
nosy: +zach.ware

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue37352] Typo in documentation: "to making it easy"

[Julien Palard]

New submission from Julien Palard :

In Doc/faq/design.rst there's "with an eye to making it easily tested.".

I'm not native english, but I think "making" is wrong here, maybe "make"?

--
assignee: docs@python
components: Documentation
keywords: easy
messages: 346141
nosy: docs@python, mdk
priority: normal
severity: normal
status: open
title: Typo in documentation: "to making it easy"
type: enhancement

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com