Merge pull request #6 from fabanc/issue-5

Updated set-up documentation

Author: fabanc

README.md

@@ -1,4 +1,4 @@
-# arcgis-plus-code-generator
+# ArcGIS Pro Plus Code Generator
 
 
 # Description
@@ -11,20 +11,66 @@ This tool is a side effect of a project I have done for work. I have explored di
 
 # System Requirements
 
-This tool is developed and tested for ArcGIS Pro. I have tested for ArcGIS Pro 2.7.
+This tool is developed and tested for ArcGIS Pro. I have tested for ArcGIS Pro 2.7. Your python environment must be of 3.x (tested with 3.7, but I assume it works with 3.6 too). 
 
-Your python environment must be of 3.x (tested with 3.7, but I assume it works with 3.6 too). 
+The open location code library for Python must be installed in your python environment. The next section will explain how to do that.
 
-The open location code library for Python must be installed in your python environment. In short
-`pip install openlocationcode`. For detailed instructions: https://github.com/google/open-location-code/tree/master/python
+# How to install
+
+## Clone your Python Environment
+
+Open ArcGIS Pro, and bring up the menu. That will let you access your Python options, and create a new Python environment. We need that since we need to install the open location code API, and that won't be allowed in ArcGIS Pro's default environment.
+ - Open ArcGIS Pro
+ - Open the menu on the left ribbon
+ - Go to the Python section of the menu.
+ - Click on manage environment
+ - Clone your default environment. Give it a meaningful name and location. In my case, I am storing my custom ArcGIS Pro environment on `D:\arcgis-pro-envs`. The name of my environment is : `arcgispro-py3-plus-code`
+
+![Cloning](images/clone-environment.png)
+
+Once cloning is over, select your new environment as your default environment when you want to use our tool. You will need to restart ArcGIS Pro.
+
+![SelectEnvironemnt](images/select-python-environment.png)
+
+
+## Install the open location code API
+
+Open a command line prompt, and use the `cd` command to navigate in the subdirectory of your newly created environment. In my case: `D:\arcgis-pro-envs\arcgispro-py3-plus-code\Scripts`. Then run the following command line:
+
+`pip install openlocationcode`. 
+
+Once it is done, the command line should look like that.
+
+![pip](images/pip-install.png)
+
+For more instructions about the open location code API, go to: https://github.com/google/open-location-code/tree/master/python
+
+# Creating a folder connection to the tool:
+
+Create a folder connection, as per the screenshot below, and navigate where you have downloaded and extracted the tool.
+
+![pip](images/folder-connection.png)
+
+You will then be able to access the tool
+
+![pip](images/folder-connection-2.png)
 
 # How to use
 
 Use the tool box in ArcGIS Pro. There is built-in help in the tool metadata, and the tool is configured to guide you and minimize input errors.
 
+In order to use the tool, double click on the tool `Get Plus Code`
+
+![pip](images/use-tools.png)
+
+The tool with then guide you through the list of parameters to provide:
+
+![pip](images/parameters.png)
+
+
+
 # How to contribute
 
-This tool has been done in rush. Though is works, it does not match my standards or the industry standards in terms of unit testing or documentation.
 If you want to help, or have any suggestion, log an issue, and a pull request if you feel bold enough. Just remember to be nice.
 
 # Data Considerations