From 42c55ae73df24a1f85c801a3350775c42a520e0c Mon Sep 17 00:00:00 2001
From: Paul Williams <pawilliams@mirantis.com>
Date: Mon, 2 Nov 2020 13:20:19 -0800
Subject: [PATCH] Updated written content in Getting started and Clusters

---
 docs/clusters/adding-clusters.md            | 15 +++++++++++----
 docs/getting-started/introductory-videos.md |  2 +-
 docs/getting-started/preferences.md         | 13 +++++++++----
 3 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/docs/clusters/adding-clusters.md b/docs/clusters/adding-clusters.md
index ded093c1a6..a89afb2f25 100644
--- a/docs/clusters/adding-clusters.md
+++ b/docs/clusters/adding-clusters.md
@@ -1,9 +1,16 @@
 # Adding clusters
 
-Add clusters by clicking the Add Cluster button in the left-side menu. You'll need to obtain a working kubeconfig for the cluster you want to add. You can either browse it from the file system or paste it as a text from the clipboard.
+Add clusters by clicking the **Add Cluster** button in the left-side menu. 
 
-Selected cluster contexts are added as a separate item in the left-side cluster menu to allow you to operate easily on multiple clusters and/or contexts.
+1. Click the **Add Cluster** button (indicated with a '+' icon).
+2. Enter the path to your kubeconfig file. You'll need to have a kubeconfig file for the cluster you want to add. You can either browse for the path from the file system or or enter it directly.
 
-**NOTE**: Any manually added cluster is not merged into your kubeconfig file.
+Selected [cluster contexts](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/#context) are added as a separate item in the left-side cluster menu to allow you to operate easily on multiple clusters and/or contexts.
 
-![Add Cluster](images/add-cluster.png)
\ No newline at end of file
+**NOTE**: Any cluster that you added manually will not be merged into your kubeconfig file.
+
+![Add Cluster](images/add-cluster.png)
+
+For more information on kubeconfig see [Kubernetes docs](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/).
+
+To see your currently-enabled config with `kubectl`, enter `kubectl config view --minify --raw` in your terminal.
\ No newline at end of file
diff --git a/docs/getting-started/introductory-videos.md b/docs/getting-started/introductory-videos.md
index 86fce6f8c9..fcaee999c0 100644
--- a/docs/getting-started/introductory-videos.md
+++ b/docs/getting-started/introductory-videos.md
@@ -1,6 +1,6 @@
 # Introductory Videos
 
-Start your journey using Lens with this set of introductory videos! These videos are designed to give you an overview of Lens various features and quickly get you familiar with them.
+Continue your Lens journey with this set of introductory videos! These videos are meant to quickly familiarize you with Lens' various powerful features. 
 
 <ul class="video-list">
 	<li class="video">
diff --git a/docs/getting-started/preferences.md b/docs/getting-started/preferences.md
index 96232b5f6b..cd71e476f8 100644
--- a/docs/getting-started/preferences.md
+++ b/docs/getting-started/preferences.md
@@ -3,21 +3,26 @@
 
 ## Color themes
 
-Color themes let you modify the colors in Lens user interface to suit your preferences and work environment.
+The Color Themes option in Lens preferences lets you set the colors in the Lens user interface to suit your liking.
 
-In Lens, open the Preferences with **File** > **Preferences**. (**Code** > **Preferences** on macOS) and select your preferred theme from the **Color Theme** dropdown. 
+1. Go to **File** > **Preferences** (**Lens** > **Preferences** on Mac). 
+2. Select your preferred theme from the **Color Theme** dropdown. 
 ![Color Theme](images/color-theme.png)
 
 
 ## Telemetry & usage tracking
 
-Lens collects telemetry data, which is used to help understand how to improve the product. For example, this usage data helps to debug issues, such as slow start-up times, and to prioritize new features. While we appreciate the insights this data provides, we also know that not everyone wants to send usage data and you can disable telemetry as described in [disable telemetry reporting](#disable-telemetry-reporting). You can also read our [privacy statement](https://www.mirantis.com/company/privacy-policy/) to learn more.
+Lens collects telemetry data, which is used to help us understand how to improve the product. For example, this usage data helps us to debug issues and to prioritize new features. While we appreciate the insights this data provides, we also know that not everyone wants to send usage data. Please see our [privacy statement](https://www.mirantis.com/company/privacy-policy/) to learn more.
 
 
 ### Disable telemetry reporting
 
 If you don't wish to send usage data to Mirantis, you can disable the "Telemetry & Usage Tracking" in the Lens preferences.
 
-From `File > Preferences` (macOS: `Lens > Preferences`), search for `Telemetry & Usage Tracking`, and uncheck the `Allow telemetry & usage tracking`. This will silence all telemetry events from Lens going forward. Telemetry information may have been collected and sent up until the point when you disable the setting.
+1. Go to **File** > **Preferences** (**Lens** > **Preferences** on Mac).
+2. Scroll down to **Telemetry & Usage Tracking**
+3. Uncheck **Allow telemetry & usage tracking**. 
+
+This will silence all telemetry events from Lens going forward. Telemetry information may have been collected and sent up until the point when you disable this setting.
 ![Disable Telemetry & Usage Tracking](images/disabled-telemetry-usage-tracking.png)