Add review suggestions around code comments

Co-authored-by: Jason R. Coombs <[email protected]>
Co-authored-by: Avasam <[email protected]>

Author: 3 people

distutils/extension.py

@@ -109,7 +109,7 @@ def __init__(
         if not isinstance(name, str):
             raise AssertionError("'name' must be a string")  # noqa: TRY004
 
-        # we handle the string case first; though strings are iterable, we disallow them
+        # handle the string case first; since strings are iterable, disallow them
         if isinstance(sources, str):
             raise AssertionError(  # noqa: TRY004
                 "'sources' must be an iterable of strings or PathLike objects, not a string"

distutils/tests/test_extension.py

@@ -69,7 +69,7 @@ def test_extension_init(self):
         assert ext.name == 'name'
 
         # the second argument, which is the list of files, must
-        # be a list of strings or PathLike objects, and not a string
+        # be an iterable of strings or PathLike objects, and not a string
         with pytest.raises(AssertionError):
             Extension('name', 'file')
         with pytest.raises(AssertionError):