Zoom installation docs update (#245)

* Add files via upload

* Update mattermost-setup.md

Changes for #230.

* Update install-zoom-plugin.md

* Update install-zoom-plugin.md

* Update mattermost-setup.md

* Update README.md

* Update webhook-configuration.md

* Update zoom-setup-jwt.md

* Update install-zoom-plugin.md

* Update README.md

* Update webhook-configuration.md

docs/installation/install-zoom-plugin.md

@@ -4,19 +4,20 @@ description: Get the Mattermost plugin installed as a first step
 
 # Install Zoom Plugin
 
-## Install via Plugin Marketplace \(Recommended\)
+## Install via Marketplace \(Recommended\)
 
-1. Go to **Main Menu > Plugin Marketplace** in Mattermost.
-2. Search for "Zoom" or manually find the plugin from the list and click **Install**.
+1. Go to **Main Menu > Plugin Marketplace** in Mattermost.
+2. Search for "Zoom" or manually find the plugin from the list and select **Install**.
 3. After the plugin has downloaded and been installed, follow the instructions on [Zoom Configuration](zoom-configuration/).
 4. After finishing the [Zoom Configuration](zoom-configuration/), follow the instructions on [Mattermost Setup](mattermost-setup.md).
 
-## \(Alternative\) Install via Manual Upload
+## \(Alternative\) Install via manual upload
 
-If your server doesn't have internet access, you can download the [latest plugin binary release](https://github.com/mattermost/mattermost-plugin-zoom/releases) and upload it to your server via **System Console > Plugin Management**. The binary releases on the page above, are the same as used by the Plugin Marketplace.
-
-1. Go to **Main Menu > Plugin Marketplace** in Mattermost.
-2. Search for "Zoom" or manually find the plugin from the list and click **Install**.
-3. After the plugin has downloaded and been installed, follow the instructions on [Zoom Configuration](zoom-configuration/).
-4. After finishing the [Zoom Configuration](zoom-configuration/), follow the instructions on [Mattermost Setup](mattermost-setup.md).
+If your server doesn't have internet access, you can download the [latest plugin binary release](https://github.com/mattermost/mattermost-plugin-zoom/releases) and upload it to your server via **System Console > Plugin Management**. The binary releases on the page above, are the same as used by the Marketplace.
 
+1. Go to **System Console > Plugins > Plugin Management**.
+2. Select **Choose File** and select the downloaded file.
+3. Choose **Upload**.
+4. When the plugin has been uploaded, navigate to **Plugins > Zoom**, choose **Enable Plugin > true**, then select **Save**
+5. Next, follow the instructions on [Zoom Configuration](zoom-configuration/).
+6. After finishing the [Zoom Configuration](zoom-configuration/), follow the instructions on [Mattermost Setup](mattermost-setup.md).

docs/installation/mattermost-setup.md

@@ -4,16 +4,16 @@ description: Configuration steps for the Mattermost server
 
 # Mattermost Setup
 
-## Zoom Plugin Setup Guide
+## Zoom plugin setup guide
 
 **Note:** You need a paid Zoom account to use the plugin.
 
 ### First steps
 
 * Enable settings for [overriding usernames](https://docs.mattermost.com/administration/config-settings.html#enable-integrations-to-override-usernames) and [overriding profile picture icons](https://docs.mattermost.com/administration/config-settings.html#enable-integrations-to-override-profile-picture-icons).
-* Go to **System Console > Plugins > Zoom** to configure the Zoom Plugin.
+* Go to **System Console > Plugins > Zoom** to configure the Zoom Plugin.
 
-![](../.gitbook/assets/system_console.png)
+![zoom plugin configuration](../.gitbook/assets/zoom-plugin-configuration.png)
 
 ### Plugin configuration
 
@@ -27,7 +27,7 @@ description: Configuration steps for the Mattermost server
   * **OAuth?**
     * Set **Enable OAuth** to `true`.
     * Use the Client ID and Client Secret generated during [Zoom Configuration](zoom-configuration/zoom-setup-oauth.md) to fill in the fields **Zoom OAuth Client ID** and **Zoom OAuth Client Secret**.
-    * Click the **Regenerate** button next to the field **At Rest Token Encryption Key**.
+    * Select **Regenerate** next to the field **At Rest Token Encryption Key**.
     * Make sure **Enable Password based authentication** is set to `false`.
     * Ignore **API Key** and **API Secret** fields.
   * **JWT/Password?**
@@ -36,5 +36,4 @@ description: Configuration steps for the Mattermost server
     * Set **Enable Password based authentication** to `true`.
     * Use the API Key and API Secret generated during [Zoom Configuration](https://github.com/mattermost/mattermost-plugin-zoom/tree/8cc104ee70b0b51ac7e4c8c73715f25c42c782e0/docs/installation/zoom-configuration/zoom-setup-jwt.md) to fill in the fields **API Key** and **API Secret**.
 * If you are using Webhooks or Deauthorization, make sure you hit the **Regenerate** button on **Webhook Secret** field.
-* Click **Save**.
-
+* Select **Save**.

docs/installation/zoom-configuration/README.md

@@ -6,21 +6,21 @@ description: >-
 
 # Zoom Configuration
 
-Zoom version 1.5 supports one authentication method for users to connect Mattermost and Zoom: OAuth 
+Zoom version 1.5 supports one authentication method for users to connect Mattermost and Zoom: OAuth.
 
-* There are two types of OAuth Zoom Apps you can create.  You can use either one with this Zoom plugin depending on your organization's security and UX preferences.  \(**Account** or **User** Level Apps\)
-  * **Account-Level App**
-    * Users do not need to authorize their Zoom accounts before starting their first Zoom meeting.  The only requirement is that their Mattermost account uses the same email address as their Zoom account. 
-    * Users cannot connect their Mattermost/Zoom accounts if their emails do not match.
-  * **User Level App**
-    * Each user will need to connect their Zoom account with their Mattermost account before they can use the integration. When they try to create a meeting for the first time, they'll receive a message to connect their account, and will need to click **Approve** on the pop-up confirmation notice.
-    * Users **can** connect their Mattermost/Zoom accounts **even if their emails do not match**.
+* There are two types of OAuth Zoom apps you can create - **Account** or **User** level apps. You can use either one with this Zoom plugin depending on your organization's security and UX preferences.
 
-## Upgrading From a Previous Version
+  * **Account-level app**
+    * Users don't need to authorize their Zoom accounts before starting their first Zoom meeting. The only requirement is that your Mattermost account uses the same email address as your Zoom account.
+    * Users can't connect their Mattermost/Zoom accounts if the emails do not match.
+  * **User-level app**
+    * Each user needs to connect their Zoom account with their Mattermost account before they can use the integration. When you try to create a meeting for the first time, you'll receive a link which redirects to a Zoom-owned website. If you're not logged in, you'll need to log in. Once logged in, select **Approve** on the pop-up confirmation notice.
+    * Users **can** connect their Mattermost/Zoom accounts **even if the emails do not match**.
+
+## Upgrading from a previous version
 
 If you've been using Zoom prior to v1.4, you likely have a legacy webhook-type app configured in Zoom.
 
-Legacy webhook apps are no longer supported by Zoom or Mattermost and are not compatible with Zoom plugin v1.4. You may experience issues with the meeting status message information not being updated when a meeting ends. This is because the webhook endpoint expects a JSON format request and newer webhooks use different formats.
+Legacy webhook apps are no longer supported by Zoom or Mattermost and are not compatible with Zoom plugin v1.4 onwards. You may experience issues with the meeting status message information not being updated when a meeting ends. This is because the webhook endpoint expects a JSON format request and newer webhooks use different formats.
 
 From Zoom v1.4, you can configure and associate your webhooks with an app you've already created. First, remove the previous webhook app. Then follow the steps provided [here](https://mattermost.gitbook.io/plugin-zoom/installation/zoom-configuration/webhook-configuration) to configure the new webhook.
-

docs/installation/zoom-configuration/webhook-configuration.md

@@ -1,21 +1,20 @@
 # Webhook Configuration
 
-## Configure Webhook Events
+## Configure webhook events
 
-When a Zoom meeting ends, the original link shared in the channel can be changed to indicate the meeting has ended and how long it lasted. To enable this functionality, we need to create a webhook subscription in Zoom that tells the Mattermost server every time a meeting ends. The Mattermost server then updates the original Zoom message.
+When a Zoom meeting ends, the original link shared in the channel can be changed to indicate the meeting has ended and how long it lasted. To enable this functionality, you can create a webhook subscription in Zoom that tells the Mattermost server every time a meeting ends. The Mattermost server then updates the original Zoom message.
 
-1. Click on **Feature**.
+1. Select **Feature**.
 2. Enable **Event Subscriptions**.
-3. Click **Add New Event Subscription** and give it a name \(e.g. "Meeting Ended"\).
+3. Select **Add New Event Subscription** and give it a name \(e.g. "Meeting Ended"\).
 4. Enter a valid **Event notification endpoint URL** \(`https://SITEURL/plugins/zoom/webhook?secret=WEBHOOKSECRET`\).
    * `SITEURL` should be your Mattermost server URL.
    * `WEBHOOKSECRET` is generated during [Mattermost Setup](../mattermost-setup.md).
 
 ![Feature screen](../../.gitbook/assets/feature.png)
 
-* Click **Add events** and select the **End Meeting** event.
+5. Select **Add events** and select the **End Meeting** event.
 
 ![Event types screen](../../.gitbook/assets/event_types.png)
 
-* Click **Done** and then save your app.
-
+6. Select **Done** and then save your app.

docs/installation/zoom-configuration/zoom-setup-jwt.md

@@ -4,26 +4,26 @@ The **API Key** and **API Secret** are generated by Zoom and used to create meet
 
 * Go to [https://marketplace.zoom.us](https://marketplace.zoom.us) and log in.
 
-## Create an App for Mattermost
+## Create an app for Mattermost
 
-* In the top left click on **Develop** and then **Build App**.
-* Select **JWT** in **Choose your app type** section.
-* Enter a name for your app.
+1. In the top left select **Develop** and then **Build App**.
+2. Select **JWT** in **Choose your app type** section.
+3. Enter a name for your app.
 
-## Configure your App to work with Mattermost
+## Configure your app to work with Mattermost
 
-* Click **Information**.
-* Enter the **Company Name** and **Developer Contact Information** for your app.
-* Click **App Credentials**.
-* Here you'll find your **API Key** and **API Secret**.
+1. Select **Information**.
+2. Enter the **Company Name** and **Developer Contact Information** for your app.
+3. Click **App Credentials**.
+4. Here you'll find your **API Key** and **API Secret**.
   * These need to be copied and pasted into the Zoom Plugin configuration screen.
 
 ![App credentials screen](https://github.com/mattermost/docs/raw/master/source/images/zoom_api_key.png)
 
-* Click **Activation** and activate the app.
+5. Select **Activation** and activate the app.
 
-Users will need to sign up for their own Zoom account using the same email address that they use for Mattermost. If the user attempts to start a Zoom meeting without a Zoom account, they will see the following error message: "We could not verify your Mattermost account in Zoom. Please ensure that your Mattermost email address matches your Zoom email address." In addition, the user must be added to the admin's Zoom account to quickly start a meeting.
+Users will need to sign up for their own Zoom account using the same email address that they use for Mattermost. If the user attempts to start a Zoom meeting without a Zoom account, they'll see the following error message: "We could not verify your Mattermost account in Zoom. Please ensure that your Mattermost email address matches your Zoom email address." In addition, the user must be added to the admin's Zoom account to quickly start a meeting.
 
-## Finish Setting up the Mattermost Server
+## Finish setting up the Mattermost server
 
 * Follow the instructions for [Mattermost Setup](../mattermost-setup.md)