(DOCSP-12645): fix tools install instructions based on new hire issues (#81)

* (DOCSP-12645): fix tools install instructions based on new hire issues

* (DOCSP-12645): update based on Naomi's feedback

Author: jwilliams-mongo

source/includes/steps-install.yaml

@@ -62,11 +62,19 @@ content: |
   The build tools require Python 3 and 2 *from Homebrew*. The version of Python
   which comes with macOS is unsupported and will **not** work.
 
-  Install Python by running:
+  Install Python 2 by running the following commmands:
 
   .. code-block:: sh
 
-     brew install python https://raw.githubusercontent.com/Homebrew/homebrew-core/86a44a0a552c673a05f11018459c9f5faae3becc/Formula/[email protected]
+     curl -LO https://raw.githubusercontent.com/Homebrew/homebrew-core/86a44a0a552c673a05f11018459c9f5faae3becc/Formula/[email protected]
+
+     brew install [email protected]
+
+  Install Python 3 by running the following command:
+
+  .. code-block:: sh
+
+     brew install [email protected]
 
 ---
 
@@ -78,7 +86,23 @@ content: |
 
   .. code-block:: sh
 
-     python2 -m pip install -r https://raw.githubusercontent.com/mongodb/docs-tools/master/giza/requirements.txt
+     python -m pip install -r https://raw.githubusercontent.com/mongodb/docs-tools/master/giza/requirements.txt
+
+  You might receive the an error containing the following text when you
+  try to install Giza, Sphinx, and their dependencies: 
+
+  .. code-block:: sh
+
+     No module named pip
+
+  If you receive this error, run the following commands, then try to
+  install Giza, Sphinx, and their dependencies again:
+
+  .. code-block:: sh
+
+     curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
+
+     python get-pip.py
 
 ---
 
@@ -103,8 +127,8 @@ content: |
 
    .. code-block:: sh
 
-      brew cask install xquartz
+      brew install --cask xquartz
 
-   Once XQuartz is installed,
-   `download and install Inkscape <https://inkscape.org/release/inkscape-0.92.2/mac-os-x/107/dmg/dl/>`__.
+   Once XQuartz is installed, `download and install Inkscape
+   <https://inkscape.org/release/inkscape-1.0.1/mac-os-x/1010-1015/dl/>`__.
 ...