clarified a few installation steps

Signed-off-by: Nick Papior <nicpa@dtu.dk>
dtudk · Sep 6, 2024 · 7ee3790 · 7ee3790
1 parent 2054ddf
commit 7ee3790
Show file tree

Hide file tree

Showing 5 changed files with 17 additions and 7 deletions.
diff --git a/docs/dropincafe/index.rst b/docs/dropincafe/index.rst
@@ -123,10 +123,15 @@ if you have a different language setting (e.g. :guilabel:`File Explorer` on Wind
        It is located somewhere else in the world, and requires internet access to interact
        with files on said storage.
 
-   * - Terminal
+   * - .. _it-skills-tbl-terminal:
+
+       Terminal
      - A program that allows one to execute commands by *writing what to do*.
        See :ref:`this table for commands <it-skills-tbl-term>`.
 
+   * - Shell
+     - Another name for a :ref:`Terminal <it-skills-tbl-terminal>`.
+
    * - PowerShell ({{windows}})
      - The recommended terminal program in Windows.
 

diff --git a/docs/install/macos/automated.rst b/docs/install/macos/automated.rst
@@ -38,8 +38,9 @@ Install everything at once
 
    #.
        Paste the following code into your Terminal and press :kbd:`Enter`.
-       You might get asked for permissions.
-       Please do this, note that your password will not be shown while typing it. 
+       You might get asked several times for your password to grant permissions.
+
+       **Note**: your password will not be shown while typing it.
 
        .. code:: bash
 

diff --git a/docs/install/macos/homebrew.rst b/docs/install/macos/homebrew.rst
@@ -35,8 +35,10 @@ Step 1: Install Homebrew
     #.  
         The Homebrew website will ask you to open a terminal.
         Find the :menuselection:`Terminal` using your Spotlight search (:kbd:`Command+Space`) and press :kbd:`Enter`.
-        You might get asked for permissions.
-        Please do this, note that your password will not be shown while typing it. 
+        You might get asked several times for your password to grant permissions.
+
+        **Note**: your password will not be shown while typing it.
+
         Do *not* close the terminal once the installation script has finished.
 
         .. image:: /images/install/MacOS-SpotlightSearch-Terminal.png

diff --git a/docs/install/windows/automated.rst b/docs/install/windows/automated.rst
@@ -40,7 +40,9 @@ Install everything at once
           :align: center
 
    #. 
-       Copy the following line of code into the PowerShell window and press :kbd:`Enter`:
+       Copy the following line of code into the PowerShell window and press :kbd:`Enter`.
+
+       **Note**: please copy *the entire line*.
 
        .. code:: pwsh
 

diff --git a/docs/install/windows/manual.rst b/docs/install/windows/manual.rst
@@ -70,7 +70,7 @@ Step 2: Install Python
 
        .. code:: pwsh
 
-          Set-ExecutionPolicy RemoteSigned
+          Set-ExecutionPolicy -Force RemoteSigned
 
        .. include:: /_rst_includes/tip-copy.rst