kartoza · amyburness · Jul 31, 2024 · Jul 22, 2024 · Jul 22, 2024 · Jul 24, 2024
diff --git a/docs/src/user/quickstart/img/quick-start-1.png b/docs/src/user/quickstart/img/quick-start-1.png
diff --git a/docs/src/user/quickstart/img/quick-start-10.png b/docs/src/user/quickstart/img/quick-start-10.png
diff --git a/docs/src/user/quickstart/img/quick-start-11.png b/docs/src/user/quickstart/img/quick-start-11.png
diff --git a/docs/src/user/quickstart/img/quick-start-12.png b/docs/src/user/quickstart/img/quick-start-12.png
diff --git a/docs/src/user/quickstart/img/quick-start-13.png b/docs/src/user/quickstart/img/quick-start-13.png
diff --git a/docs/src/user/quickstart/img/quick-start-14.png b/docs/src/user/quickstart/img/quick-start-14.png
diff --git a/docs/src/user/quickstart/img/quick-start-15.png b/docs/src/user/quickstart/img/quick-start-15.png
diff --git a/docs/src/user/quickstart/img/quick-start-16.png b/docs/src/user/quickstart/img/quick-start-16.png
diff --git a/docs/src/user/quickstart/img/quick-start-2.png b/docs/src/user/quickstart/img/quick-start-2.png
diff --git a/docs/src/user/quickstart/img/quick-start-3.png b/docs/src/user/quickstart/img/quick-start-3.png
diff --git a/docs/src/user/quickstart/img/quick-start-4.png b/docs/src/user/quickstart/img/quick-start-4.png
diff --git a/docs/src/user/quickstart/img/quick-start-5.png b/docs/src/user/quickstart/img/quick-start-5.png
diff --git a/docs/src/user/quickstart/img/quick-start-6.png b/docs/src/user/quickstart/img/quick-start-6.png
diff --git a/docs/src/user/quickstart/img/quick-start-7.png b/docs/src/user/quickstart/img/quick-start-7.png
diff --git a/docs/src/user/quickstart/img/quick-start-8.png b/docs/src/user/quickstart/img/quick-start-8.png
diff --git a/docs/src/user/quickstart/img/quick-start-9.png b/docs/src/user/quickstart/img/quick-start-9.png
diff --git a/docs/src/user/quickstart/quick-start.md b/docs/src/user/quickstart/quick-start.md
@@ -0,0 +1,149 @@
+# Quick Start Guide for Downloading QGIS
+
+*QGIS, short for Quantum Geographic Information System, is a free and open-source software used for working with geospatial data. This data can be easily edited and analyzed within QGIS. As a cross-platform application, it is widely used in geographic data applications and runs on different operating systems, including Windows, Mac, and Linux. QGIS is written in Python, C++, and Qt.
+
+## How to install QGIS:
+
+- **Step 1: Visit the QGIS Website:** Open your web browser and go to the QGIS official website: [QGIS Download Page](https://www.qgis.org/download/).
+![Download QGIS](./img/quick-start-11.png)
+
+- **Step 2: Choose Your Operating System:** On the download page, you will see options for different operating systems (Windows, macOS, Linux, etc.). Select the download option that matches your operating system.
+
+    Click on the 1️⃣ `Download for Windows`. To view the versions available for download.
+
+    - **Choose Your Version:** On the download page, you will see multiple versions of QGIS. Choose the version that is recommended for your needs. Generally, the Long Term Release (LTR) is recommended for most users as it is the most stable version. Download the LTR.
+
+    ![Download QGIS](./img/quick-start-12.png)
+
+
+- **Step 3: Installing QGIS**
+
+Once the download is complete, locate the downloaded file in your Downloads folder or the location you specified. Double-click the installer file to start the installation process.
+
+## Follow the Installation Wizard:
+
+- The QGIS Setup Wizard will open. Follow the prompts: Click `Next` to start the installation process.
+
+![Install QGIS](./img/quick-start-13.png)
+
+- The second window will include all the licenses that you have to agree with in order to get `QGIS` installed. Check the 1️⃣ `I accept the terms in the License Agreement` box then click on the 2️⃣ `Next` button.
+
+![Install QGIS](./img/quick-start-14.png)
+
+- Next you will be prompted to select the install location. This is the same thing as the installation path and this is where your QGIS version will be installed. It is recommended to go with the default one that is `C:\Program Files\QGIS 3.34` for windows. Please note that the QGIS version number may vary based on the current LTR.
+
+- Select the components you wish to install. For a full installation, leave all options checked and click `Next`.
+
+![Install QGIS](./img/quick-start-15.png)
+
+- Click `Install` to begin the installation.
+
+- Complete the Installation: The installer will copy the necessary files to your computer. This process may take a few minutes. Once the installation is complete, click `Finish` to exit the Setup Wizard.
+
+## Launch QGIS:
+You can now launch QGIS from your Start menu or desktop shortcut.
+
+## Additional Notes
+
+## For MacOS Users
+
+If you are using macOS, follow the instructions provided here:
+
+When attempting to launch QGIS for the first time on macOS, there is a chance that macOS will `initially block it due to its origin from the internet. To enable its execution, follow these steps:
+
+1. Navigate to `System Preferences`.
+2. Select `Security & Privacy`.
+3. In the `General` tab, you will encounter a notification indicating that QGIS is being blocked. Click on the `Open Anyway` button.
+
+![MacOS](./img/quick-start-16.png)
+
+4. A confirmation dialog will pop up. Click `Open` to commence QGIS.
+
+## For Non-Administrators:
+
+When installing QGIS, it's essential to select an installation directory where you have write access on your computer. During the installation process, you will be prompted to choose the installation directory. To ensure successful installation without administrator privileges, specify a path within your user directory or any location where you have the necessary write access. This allows you to use the QGIS on your system effectively while bypassing the need for administrative permissions.
+
+By following these steps, you can quickly download and install QGIS on your Windows system and get started with your GIS projects.
+
+# Quick Start Guide: GEA Re-Afforestation Plugin
+
+## Introduction
+
+This quick start guide will help you install the Planet Explorer plugin in QGIS.
+
+## Steps to Install the Plugin
+
+- **Open QGIS:** Launch the QGIS application on your computer.
+
+![Plugins option](./img/quick-start-1.png)
+
+- **Access the Plugins Menu:** Click on the 1️⃣ `Plugins` option available in the navbar section at the top of the QGIS window. Upon clicking you will see the other option for plugin.
+
+![Option](./img/quick-start-2.png)
+
+- **Manage and Install Plugins** Select the 1️⃣ `Manage and Install Plugins..` option from the dropdown menu.
+
+![Search bar](./img/quick-start-3.png)
+
+- **Search for the Plugin:** In the Plugin Manager window, click on the 1️⃣ search bar and type Planet_explorer.
+
+![Install plugin](./img/quick-start-4.png)
+
+- **Select and Install:** Once you find the Planet_explorer plugin in the search results, select it by clicking on the 1️⃣ `Planet_Explorer` and then click on the 2️⃣ `Install Plugin` button.
+
+![Installed](./img/quick-start-5.png)
+
+After the installation, you will see the login option.
+
+![Login](./img/quick-start-6.png)
+
+After installing the plugin you will see the option for login to the `Planet Explorer` site. register to the site and log in to view Norway’s International Climate & Forests Initiative (NICFI), imagery.
+
+Click on the [sign-up](../manual/sign-up.md) to view the detailed documentation on how to sign up on the `Planet Explorer` site.
+
+Click on the [login](../manual/login.md) to view the detailed documentation on how to log in on the `Planet Explorer` site.
+
+## Login
+
+Click on the login button and login to the planet explorer. Upon logging in you will see options like upload, draw, select or extent layers.
+
+![Planet imagery](./img/quick-start-7.png)
+
+## Accessing Project Data
+
+- **Project Folder Delivery:** You need to ask for the project folder from your head office containing all the necessary data for your project. 
+
+### This folder will include:
+
+- **Landsat Images:** These images will be stored within the project folder.
+
+- **Vector Data Layers:** All required vector data layers will also be included in the project folder.
+
+### Streaming Additional Imagery
+
+- **NICFI and Google Imagery:** The `NICFI` and `Google` imagery are not stored locally but are streamed directly into the project. To access this streamed imagery, you need the Planet Explorer plugin installed and configured in QGIS.
+
+## Loading the Project
+
+![Upload](./img/quick-start-8.png)
+
+To use this data you need to upload it to the plugin. Click on the 1️⃣ `Upload` button, and select the `GTI-GEA-Malawi 2.qgz` file from the system. This file will automatically load all the Landsat images and vector data layers from the project folder.
+
+## Handling Unavailable Layers
+
+- **Handle Unavailable Layer Pop-up:** If any layer is unavailable, you will see the `Handle Unavailable Layer` pop-up.
+
+- **Keep Unavailable Layers:** Click on the 1️⃣ `Keep Unavailable Layers` option to continue.
+
+    ![Upload](./img/quick-start-9.png)
+
+- **Successful Upload:** On successful upload, you will see the data loaded into QGIS.
+
+    ![Layers](./img/quick-start-10.png)
+
+### Streaming NICFI and Google Imagery
+
+Accessing Streamed Imagery: With the Planet Explorer plugin installed, the NICFI and Google imagery will be streamed into your QGIS project, allowing you to view and analyse this data alongside your locally stored Landsat images and vector data layers.
+
+## Conclusion
+You have now successfully installed the Planet Explorer plugin and accessed your project data in QGIS. This setup will enable you to work with both locally stored data and streamed imagery efficiently.