Merge pull request #11731 from cnpryer/docs-fix

docs/html/development/architecture/overview.rst

@@ -24,9 +24,9 @@ Things pip does:
            backwards compatibility reasons. But thing with setuptools:
            has a ``setup.py`` file that it invokes to …… get info?
 
-2. Decides where to install stuff. Once the package is built, resulting
-   artifact is then installed into system in appropriate place. :pep:`517`
-   defines interface between build backend & installer.
+2. Decides where to install stuff. Once the package is built, the resulting
+   artifact is then installed to the system in its appropriate place. :pep:`517`
+   defines the interface between the build backend & installer.
 
 Broad overview of flow
 ======================
@@ -111,24 +111,24 @@ The package index gives pip a list of files for that package (via the existing P
 
 pip chooses from the list a single file to download.
 
-It may go back and choose another file to download
+It may go back and choose another file to download.
 
 When pip looks at the package index, the place where it looks has
-basically a link. The link’s text is the name of the file
+basically a link. The link’s text is the name of the file.
 
 This is the `PyPI Simple API`_ (PyPI has several APIs, some are being
 deprecated). pip looks at Simple API, documented initially at :pep:`503` --
 packaging.python.org has PyPA specifications with more details for
-Simple Repository API
+Simple Repository API.
 
-For this package name -- this is the list of files available
+For this package name -- this is the list of files available.
 
 Looks there for:
 
 * The list of filenames
 * Other info
 
-Once it has those, selects one file, downloads it
+Once it has those, it selects one file and downloads it.
 
 (Question: If I want to ``pip install flask``, I think the whole list of filenames
 cannot….should not be …. ? I want only the Flask …. Why am I getting the

docs/html/user_guide.rst

@@ -800,7 +800,7 @@ As noted previously, pip is a command line program. While it is implemented in
 Python, and so is available from your Python code via ``import pip``, you must
 not use pip's internal APIs in this way. There are a number of reasons for this:
 
-#. The pip code assumes that is in sole control of the global state of the
+#. The pip code assumes that it is in sole control of the global state of the
    program.
    pip manages things like the logging system configuration, or the values of
    the standard IO streams, without considering the possibility that user code