more explict about what remote means in context

story645 · timhoffm · story645 · commit 88a6faf21bd2 · 2023-05-10T18:44:14.000-04:00
building off of #25828 and @timhoffm's comment, mostly reworded/moved things (very little if any change in length) to try and make it more explicit that in this context origin and upstream are aliases for remote repositories. Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst
@@ -35,8 +35,8 @@ Retrieve the latest version of the code
 =======================================
 
 Now that your fork of the repository lives under your GitHub username, you can
-retrieve the latest sources with one of the following commands (where your
-should replace ``<your-username>`` with your GitHub username):
+retrieve the most recent version of the source code with one of the following
+commands (replace ``<your-username>`` with your GitHub username):
 
 .. tab-set::
 
@@ -59,14 +59,12 @@ should replace ``<your-username>`` with your GitHub username):
 
 
 This will place the sources in a directory :file:`matplotlib` below your
-current working directory and set up the ``origin`` remote to point to your own
-fork.  Change into this directory before continuing::
+current working directory and set the remote name ``origin`` to point to your
+fork. Change into this directory before continuing::
 
     cd matplotlib
 
-Now set up the ``upstream`` remote to point to the Matplotlib main repository,
-so that you can access the latest changes there (see also `Managing remote repositories
-<https://docs.github.com/en/get-started/getting-started-with-git/managing-remote-repositories>`__.):
+Now set the remote name ``upstream`` to point to the Matplotlib main repository:
 
 .. tab-set::
 
@@ -82,6 +80,10 @@ so that you can access the latest changes there (see also `Managing remote repos
 
          git remote add upstream git@github.com:matplotlib/matplotlib.git
 
+You can now use ``upstream`` to retrieve the most current snapshot of the source
+code, as described in :ref:`development-workflow`.  See also `Managing remote repositories
+<https://docs.github.com/en/get-started/getting-started-with-git/managing-remote-repositories>`__.
+
 .. note::
 
   For more information on ``git`` and ``GitHub``, check the following resources.
