doc: add gs assistant installation page

Added GS Assistant page and edited cross-links.

Signed-off-by: Grzegorz Ferenc <[email protected]>

Author: greg-fer

doc/nrf/getting_started.rst

@@ -3,7 +3,7 @@
 Getting started
 ###############
 
-To quickly get started with the |NCS|, use the `Getting Started Assistant <Getting Started Information_>`_ to set up your development environment.
+To quickly get started with the |NCS|, use the :ref:`Getting Started Assistant <gs_assistant>` to set up your development environment.
 Alternatively, check the :ref:`gs_installing` section for instructions on setting up your environment manually.
 
 We recommend using SEGGER Embedded Studio for building your applications. See :ref:`gs_programming` for the download links and instructions.
@@ -16,6 +16,7 @@ After that, pick a sample that is related to the application you want to create
 .. toctree::
    :maxdepth: 2
 
+   gs_assistant
    gs_installing
    gs_programming
    gs_testing

doc/nrf/gs_assistant.rst

@@ -0,0 +1,76 @@
+.. _gs_assistant:
+
+Installing the |NCS| with the |GSA|
+###################################
+
+The |GSA| application provides you with step-by-step instructions for installing the toolchain for |NCS|.
+
+The application allows you to check which of the required tools are already installed on your computer and verify the installation.
+It also guides you through installing the parts of the toolchain that you are missing.
+In addition, it will help you clone the |NCS| repositories and set up your first project in |SES|.
+
+.. _gs_assistant_installing-gsa:
+
+Installing the |GSA|
+********************
+
+The |GSA| app is available in `nRF Connect for Desktop`_, a cross-platform tool available for Windows, Linux, and macOS.
+
+To install the Assistant app, complete the following steps:
+
+.. _assistant_setup:
+
+1. `Download nRF Connect for Desktop`_ for your operating system.
+#. Install and run the tool on your machine.
+#. In the APPS section, click :guilabel:`Install` next to |GSA|.
+
+.. figure:: images/gs-assistant_installation.PNG
+   :alt: The nRF Connect for Desktop main window
+
+   The nRF Connect for Desktop main window
+
+The app is installed on your machine, and the :guilabel:`Install` button changes to :guilabel:`Open`.
+
+.. _gs_assistant_installing-ncs:
+
+Installing the |NCS|
+********************
+
+Once you have installed |GSA|, open it in nRF Connect for Desktop.
+The |GSA| app opens with the Overview section displayed in the main window.
+
+You can now go through each of the sections and complete the listed installation steps.
+
+To provide installation variables, use the Variables section.
+If you need to edit any of the fields, click on it.
+
+.. figure:: images/gs-assistant_variables.PNG
+   :alt: The Variables section of the |GSA| app main window, cropped
+
+   The Variables section
+
+.. _gs_assistant_installing-ncs_verify:
+
+Verification options
+====================
+
+Next to each step, you can use one or both of the following buttons:
+
+- :guilabel:`Mark done` -- marks a step as completed.
+- :guilabel:`Verify` -- checks if the installation is correct.
+
+The verification process is reflected in the vertical progress bar animation.
+Once the verification is successful, the vertical progress bar changes color to green and the Log section is updated.
+At the same time, the :guilabel:`Mark done` button changes to :guilabel:`Mark not done`.
+
+.. figure:: images/gs-assistant_UI.gif
+   :alt: Verifying the |NCS| toolchain installation in the |GSA| app
+
+   Verifying the |NCS| toolchain installation
+
+If there is an issue, the Log section is updated with the related error.
+
+.. figure:: images/gs-assistant_log.PNG
+   :alt: The Log section of the |GSA| app main window with an error highlighted in red, cropped
+
+   The Log section with an error highlighted in red

doc/nrf/gs_installing.rst

@@ -1,14 +1,11 @@
 .. _gs_installing:
 
 
-Installing the |NCS|
-####################
+Installing the |NCS| manually
+#############################
 
 The recommended way to get started with the |NCS| is to run the Getting Started Assistant app in nRF Connect for Desktop.
-See the `Getting Started information`_ on the nRF9160 DK product page for information about how to install the Getting Started Assistant.
-
-The Getting Started Assistant checks which of the required tools are already installed on your computer and guides you through installing the parts of the toolchain that you are missing.
-In addition, it will help you clone the |NCS| repositories and set up your first project in |SES|.
+See the :ref:`gs_assistant` section for information about how to install the Getting Started Assistant.
 
 .. note::
    If you use the Getting Started Assistant, you can skip this section of the documentation.

doc/nrf/images/gs-assistant_UI.gif

@@ -60,8 +60,6 @@
 
 .. _`DevZone`: https://devzone.nordicsemi.com/
 
-.. _`Getting Started information`: https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF9160-DK/GetStarted#infotabs
-
 .. _`nRF9160 DK product page`: https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF9160-DK/Download#infotabs
 
 .. _`nRF9160 product website`: https://www.nordicsemi.com/Products/Low-power-cellular-IoT/nRF9160-SiP
@@ -83,6 +81,7 @@
 .. _`nRF5x Command Line Tools OSX`: https://www.nordicsemi.com/Software-and-Tools/Development-Tools/nRF5-Command-Line-Tools
 
 .. _`nRF Connect for Desktop`: https://www.nordicsemi.com/Software-and-Tools/Development-Tools/nRF-Connect-for-desktop
+.. _`Download nRF Connect for Desktop`: https://www.nordicsemi.com/Software-and-Tools/Development-Tools/nRF-Connect-for-desktop/Download#infotabs
 
 .. _`nRF Connect for Mobile`: https://www.nordicsemi.com/Software-and-Tools/Development-Tools/nRF-Connect-for-mobile
 

doc/nrf/images/gs-assistant_installation.PNG

@@ -9,3 +9,5 @@
 
 .. |connect_terminal_specific| replace:: Connect to the board that runs this sample with a terminal emulator (for example, PuTTY).
    See :ref:`putty` for the required settings.
+
+.. |GSA| replace:: Getting Started Assistant