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

Change by Raymond Hettinger : -- resolution: -> fixed stage: patch review -> resolved status: open -> closed versions: +Python 3.9 ___ Python tracker ___ _

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

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

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

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 crea

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

Change by Ilya Kamenshchikov : -- keywords: +patch pull_requests: +14525 stage: -> patch review pull_request: https://github.com/python/cpython/pull/14730 ___ Python tracker _

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

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. --

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

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

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

Raymond Hettinger added the comment: It reads fine to me as is. -- nosy: +rhettinger ___ Python tracker ___ ___ Python-bugs-list ma

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

YoSTEALTH added the comment: programmers "plan" their code, they don't "design" it, as far as i know! -- ___ Python tracker ___ ___

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

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

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

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 __

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

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 goa

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

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, m