From 7ee3790bb47dcadcdee4e6c17d4412f80990d432 Mon Sep 17 00:00:00 2001 From: Nick Papior Date: Fri, 6 Sep 2024 09:51:04 +0200 Subject: [PATCH] clarified a few installation steps Signed-off-by: Nick Papior --- docs/dropincafe/index.rst | 7 ++++++- docs/install/macos/automated.rst | 5 +++-- docs/install/macos/homebrew.rst | 6 ++++-- docs/install/windows/automated.rst | 4 +++- docs/install/windows/manual.rst | 2 +- 5 files changed, 17 insertions(+), 7 deletions(-) diff --git a/docs/dropincafe/index.rst b/docs/dropincafe/index.rst index 2af9894b..eaf1b8b7 100644 --- 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 `. + * - Shell + - Another name for a :ref:`Terminal `. + * - PowerShell ({{windows}}) - The recommended terminal program in Windows. diff --git a/docs/install/macos/automated.rst b/docs/install/macos/automated.rst index 87b14b40..089f6446 100644 --- 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 index f1432a61..e2555fff 100644 --- 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 index 7a9c0ab9..0bbb73c5 100644 --- 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 index a764a182..54cef68d 100644 --- 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