Update software setup instructions

UMCarpentries · Nov 20, 2023 · 7ed388e · 7ed388e
1 parent 0c34983
commit 7ed388e
Show file tree

Hide file tree

Showing 2 changed files with 29 additions and 12 deletions.
diff --git a/_includes/install_instructions/python.html b/_includes/install_instructions/python.html
@@ -44,15 +44,22 @@ <h3>Python</h3>
 
     <div class="tab-content">
       <article role="tabpanel" class="tab-pane active" id="python-windows">
+        Install Anaconda
         <ol>
           <li>Open <a href="https://www.anaconda.com/download">https://www.anaconda.com/download</a> with your web browser.</li>
           <li>Download the Anaconda for Windows installer. </li>
           <li>Run the Anaconda Installer, using all of the defaults for installation <em>except</em> make sure to check <strong>Make Anaconda the default Python</strong>.</li>
-          <li>Once Anaconda is installed, launch the Anaconda Prompt by going to the Windows search bar, type in <code>anaconda prompt</code>, and press Enter.</li>
-          <li>In the Anaconda Prompt type <code>jupyter lab</code> and press Enter. This will open JupyterLab in your browser.</li>
+          <li>Once Anaconda is installed, launch the Anaconda Prompt by going to the Windows search bar, type in <code>anaconda prompt</code>, and press <kbd>Enter</kbd>.</li>
+          <li>In the Anaconda Prompt type <code>jupyter lab</code> and press <kbd>Enter</kbd>. This will open JupyterLab in your browser.</li>
           <!-- <li>To keep the JupyterLab running, do not close the command line window (you can minimize it), as it works as JupterLab's "local host server".</li> -->
         </ol>
-        Note: To keep the JupyterLab running, do not close the command line window (you can minimize it), as it works as JupterLab's "local host server".
+        Launch JupyterLab
+        <ol>
+          <li>Once Anaconda is installed, launch the Anaconda Prompt by going to the Windows search bar, type in <code>anaconda prompt</code>, and press <kbd>Enter</kbd>.</li>
+          <li>In the Anaconda Prompt type <code>jupyter lab</code> and press <kbd>Enter</kbd>. This will launch JupyterLab in your browser.</li>
+          <li>Note to keep the JupyterLab running, do not close the command line window (you can minimize it), as it works as JupterLab's "local host server".</li>
+        </ol>
+
         <!-- <h4>Video Tutorial</h4>
         <div class="yt-wrapper2">
         <div class="yt-wrapper">
@@ -61,14 +68,20 @@ <h3>Python</h3>
         </div> -->
       </article>
       <article role="tabpanel" class="tab-pane" id="python-macos">
+        Install Anaconda
         <ol>
           <li>Open <a href="https://www.anaconda.com/download">https://www.anaconda.com/download</a> with your web browser.</li>
           <li>Download the Anaconda Installer for macOS. You may need to choose an installer between an Intel-chip Mac and Apple silicon (e.g., M1/M2) Mac.</li>
           <li>Run the Anaconda Installer, using all of the defaults for installation <em>except</em> make sure to check <strong>Make Anaconda the default Python</strong>.</li>
-          <li>Once Anaconda is installed, type <code>jupyter lab</code> in your Terminal and press Return. This will open JupyterLab in your browser.</li>
+          <li>Once Anaconda is installed, type <code>jupyter lab</code> in your Terminal and press <kbd>Return</kbd>. This will launch JupyterLab in your browser.</li>
           <!-- <li>To keep the JupyterLab running, do not close the Terminal window (you can minimize it), as it works as JupterLab's "local host server".</li> -->
         </ol>
-        Note: To keep the JupyterLab running, do not close the command line window (you can minimize it), as it works as JupterLab's "local host server".
+        Launch JupyterLab
+        <ol>
+          <li>Once Anaconda is installed, launch the Terminal window, type in <code>jupyter lab</code>, and press <kbd>Return</kbd>. This will launch JupyterLab in your browser.</li>
+          <li>Note to keep the JupyterLab running, do not close the Terminal window (you can minimize it), as it works as JupterLab's "local host server".</li>
+        </ol>
+        <!-- Note: To keep the JupyterLab running, do not close the command line window (you can minimize it), as it works as JupterLab's "local host server". -->
         <!-- <h4>Video Tutorial</h4>
         <div class="yt-wrapper2">
         <div class="yt-wrapper">
@@ -77,6 +90,7 @@ <h3>Python</h3>
         </div> -->
       </article>
       <article role="tabpanel" class="tab-pane" id="python-linux">
+        Install Anaconda
         <ol>
           <li>Open <a href="https://www.anaconda.com/download">https://www.anaconda.com/download</a> with your web browser.</li>
           <li>Download the Anaconda Installer for Linux.<br>
@@ -89,7 +103,7 @@ <h3>Python</h3>
             the executable is downloaded (e.g., `cd ~/Downloads`).
           </li>
           <li>
-            Type <pre>bash Anaconda3-</pre> and then press
+            Type <code>bash Anaconda3-</code> and then press
             <kbd>Tab</kbd> to autocomplete the full file name. The name of
             file you just downloaded should appear.
           </li>
@@ -107,10 +121,14 @@ <h3>Python</h3>
             to prepend Anaconda to your <code>PATH</code>
             (this makes the Anaconda distribution the default Python).
           </li>
-          <li>Once Anaconda is installed, type <code>jupyter lab</code> in your Terminal and press Return. This will open JupyterLab in your browser.</li>
+          <li>Once Anaconda is installed, type <code>jupyter lab</code> in your Terminal and press <kbd>Return</kbd>. This will launch JupyterLab in your browser.</li>
           <!-- <li>To keep the JupyterLab running, do not close the Terminal window (you can minimize it), as it works as JupterLab's "local host server".</li> -->
         </ol>
-        Note: To keep the JupyterLab running, do not close the command line window (you can minimize it), as it works as JupterLab's "local host server".
+        Launch JupyterLab
+        <ol>
+          <li>Once Anaconda is installed, launch the Terminal window, type in <code>jupyter lab</code>, and press <kbd>Return</kbd>. This will launch JupyterLab in your browser.</li>
+          <li>Note to keep the JupyterLab running, do not close the Terminal window (you can minimize it), as it works as JupterLab's "local host server".</li>
+        </ol>
       </article>
     </div>
   </div>

diff --git a/_includes/install_instructions/shell.html b/_includes/install_instructions/shell.html
@@ -2,7 +2,7 @@
   <h3>The Unix Shell</h3>
   <p>
     The <a href="https://en.wikipedia.org/wiki/Unix_shell">Unix shell</a> is a <a href="https://en.wikipedia.org/wiki/Command-line_interface">command-line interface</a> that gives you the power to do
-    tasks more quickly.
+    tasks more quickly and reproducibly.
   </p>
 
   <div>
@@ -108,10 +108,9 @@ <h4>Video Tutorial</h4>
         <p>
           The default shell in newer versions of macOS is Z shell, also known as zsh, and
 	  it comes pre-installed with your MacOS.
-	  You access shell from the Terminal (found in
-	  <code>/Applications/Utilities</code>).
+	  You access shell from the Terminal, which can be launched with a Spotlight Search by typing "terminal" or in <code>/Applications/Utilities</code>.
           See the Git installation <a href="#shell-macos-video-tutorial">video tutorial</a>
-          for an example on how to open the Terminal.
+          for an example on how to launch the Terminal.
           You may want to keep Terminal in your dock for this workshop.
         </p>
         <!-- <p>