Documentation Fixes (#37)

Resolves CatalystCode/project-fortis-pipeline#253

Author: rachelnicole

project-fortis-pipeline/docs/development-faq.md

@@ -137,3 +137,7 @@ that pre-populate your Fortis site.
 
 There are several examples of tar.gz files to bootstrap sites in the [seed-data](https://github.com/CatalystCode/project-fortis/tree/master/project-fortis-pipeline/localdeploy/seed-data)
 directory which you can use as a template.
+
+## Why isn't my UI loading?
+
+If you see `An error occurred while loading the page: GraphQL call failed` when trying to load the Dashboard, your `docker-compose up` process is either not done running, or you might need to pull down fresh from your Master branch and rebuild.

project-fortis-pipeline/docs/development-setup.md

@@ -43,6 +43,8 @@ single resource group whose name is stored under the
 
 ### Generating Mapbox access token
 
+Mapbox is a service that allows you to simply create beautiful maps and location services through APIs and SDKs. They have extensive documentation which you can find [here](https://www.mapbox.com/api-documentation/#maps).
+
 Next, you need to create a Mapbox access token. If you don't have one yet, you
 can create a new one for free by [signing up](https://www.mapbox.com/signup/).
 Once you have the token, append it to the `.env-secrets` file like so:
@@ -121,4 +123,4 @@ Note that any changes to the React code in project-fortis-interfaces folder will
 be automatically detected and re-loaded so the re-build step above won't be
 necessary for changes to the frontend.
 
-If you're facing any issues, refer to the [Development FAQ](./development-faq.md).
+If you're facing any issues, refer to the [Development FAQ](./development-faq.md).

project-fortis-pipeline/docs/production-setup.md

@@ -1,14 +1,23 @@
-# Fortis production setup
+# Fortis production 
 
 ## Prerequisites
 
 ### Azure subscription
 
-First and foremost, you'll need an Azure subscription. You can create one for
-free [here](https://azure.microsoft.com/en-us/free/).
+First and foremost, you'll need an Azure subscription. 
+
+Azure is a comprehensive set of cloud services that developers and IT professionals use to build, deploy, and manage applications through our global network of datacenters. Integrated tools, DevOps, and a marketplace support you in efficiently building anything from simple mobile apps to internet-scale solutions.
+
+A full list of products and services can be found [here](https://azure.microsoft.com/en-us/services/).
+
+And you can create an account for free [here](https://azure.microsoft.com/en-us/free/).
+
+For this project we're using these services: [Blob Storage](https://azure.microsoft.com/en-us/services/storage/blobs/), [Cognitive Services](https://azure.microsoft.com/en-us/services/cognitive-services/), [Azure Database for PostgreSQL](https://azure.microsoft.com/en-us/services/postgresql/), [Service Bus](https://azure.microsoft.com/en-us/services/service-bus/), [Active Directory v2](https://azure.microsoft.com/en-us/services/active-directory/), [Container Service](https://azure.microsoft.com/en-us/services/container-service/) and [Event Hubs](https://azure.microsoft.com/en-us/services/event-hubs/).
 
 ### Secure your Fortis site with TLS
 
+TLS is the successcor to SSL. The TLS protocol aims primarily to provide privacy and data integrity between two communicating computer applications. You can find more information about it [here](https://en.wikipedia.org/wiki/Transport_Layer_Security)
+
 To enable TLS and secure your Fortis site, you have two choices:
 
 1. Provide your own TLS certificate and private key