From 9f8ea0cf5d0192a51a3c7a69225d531cc4269dd3 Mon Sep 17 00:00:00 2001 From: Paul Williams Date: Thu, 29 Oct 2020 15:14:01 -0700 Subject: [PATCH 1/5] Changed index.md content, some file names, some directory names, and associated changes to mkdocs.yml nav --- .../{add-cluster.md => adding-clusters.md} | 0 ...remove-cluster.md => removing-clusters.md} | 0 docs/get-started/telemetry.md | 10 --- docs/getting-started/downloading-lens.md | 59 ++++++++++++++++++ .../images/color-theme.png | Bin .../disabled-telemetry-usage-tracking.png | Bin .../images/snap-store.png | Bin .../introductory-videos.md} | 0 .../preferences.md} | 0 docs/index.md | 34 ++++------ docs/setup/linux.md | 19 ------ docs/setup/macos.md | 9 --- docs/setup/network.md | 8 --- docs/setup/overview.md | 23 ------- docs/setup/windows.md | 7 --- mkdocs.yml | 23 +++---- 16 files changed, 80 insertions(+), 112 deletions(-) rename docs/clusters/{add-cluster.md => adding-clusters.md} (100%) rename docs/clusters/{remove-cluster.md => removing-clusters.md} (100%) delete mode 100644 docs/get-started/telemetry.md create mode 100644 docs/getting-started/downloading-lens.md rename docs/{get-started => getting-started}/images/color-theme.png (100%) rename docs/{get-started => getting-started}/images/disabled-telemetry-usage-tracking.png (100%) rename docs/{setup => getting-started}/images/snap-store.png (100%) rename docs/{get-started/intro-videos.md => getting-started/introductory-videos.md} (100%) rename docs/{get-started/themes.md => getting-started/preferences.md} (100%) delete mode 100644 docs/setup/linux.md delete mode 100644 docs/setup/macos.md delete mode 100644 docs/setup/network.md delete mode 100644 docs/setup/overview.md delete mode 100644 docs/setup/windows.md diff --git a/docs/clusters/add-cluster.md b/docs/clusters/adding-clusters.md similarity index 100% rename from docs/clusters/add-cluster.md rename to docs/clusters/adding-clusters.md diff --git a/docs/clusters/remove-cluster.md b/docs/clusters/removing-clusters.md similarity index 100% rename from docs/clusters/remove-cluster.md rename to docs/clusters/removing-clusters.md diff --git a/docs/get-started/telemetry.md b/docs/get-started/telemetry.md deleted file mode 100644 index 77ecb2a2ff..0000000000 --- a/docs/get-started/telemetry.md +++ /dev/null @@ -1,10 +0,0 @@ -# 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. - -## 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. -![Disable Telemetry & Usage Tracking](images/disabled-telemetry-usage-tracking.png) diff --git a/docs/getting-started/downloading-lens.md b/docs/getting-started/downloading-lens.md new file mode 100644 index 0000000000..3fc5365052 --- /dev/null +++ b/docs/getting-started/downloading-lens.md @@ -0,0 +1,59 @@ +# Downloading Lens + +Lens is lightweight and simple to install. You'll be up and running in just a few minutes. + + +## macOS + +1. [Download Lens](https://github.com/lensapp/lens/releases) for macOS. +2. Open the browser's download list and locate the downloaded archive. +3. Select the 'magnifying glass' icon to open the archive in Finder. +4. Double-click `Lens-{version}.dmg` and drag `Lens.app` to the `Applications` folder, making it available in the macOS Launchpad. +5. Add Lens to your Dock by right-clicking on the icon to bring up the context menu and choosing **Options**, **Keep in Dock**. + + +## Windows + +1. Download the [Lens installer](https://github.com/lensapp/lens/releases) for Windows. +2. Once it is downloaded, run the installer `Lens-Setup-{version}.exe`. This will only take a minute. +3. By default, Lens is installed under `C:\users\{username}\AppData\Local\Programs\Lens`. + + +## Linux + +See the [Download Lens](https://github.com/lensapp/lens/releases) page for a complete list of available installation options. + + +### Snap + +Lens is officially distributed as a Snap package in the [Snap Store](https://snapcraft.io/store): + +[![Get it from the Snap Store](images/snap-store.png)](https://snapcraft.io/kontena-lens) + +You can install it by running: + +```bash +sudo snap install kontena-lens --classic +``` + + +## Network + +Lens is built on top of Electron and benefits from all the networking stack capabilities of Chromium. + + +### Proxy server support + +... + + +## Update cadence + +Lens releases a new version each month with new features and important bug fixes. Lens supports auto updating and you will be prompted to install the new release when it becomes available! + +To stay current with the Lens features, you can review the [release notes](https://github.com/lensapp/lens/releases). + + +## Quickstart + +Learn to [add clusters](/clusters/add-cluster/) to improve productivity and increase the speed of business. \ No newline at end of file diff --git a/docs/get-started/images/color-theme.png b/docs/getting-started/images/color-theme.png similarity index 100% rename from docs/get-started/images/color-theme.png rename to docs/getting-started/images/color-theme.png diff --git a/docs/get-started/images/disabled-telemetry-usage-tracking.png b/docs/getting-started/images/disabled-telemetry-usage-tracking.png similarity index 100% rename from docs/get-started/images/disabled-telemetry-usage-tracking.png rename to docs/getting-started/images/disabled-telemetry-usage-tracking.png diff --git a/docs/setup/images/snap-store.png b/docs/getting-started/images/snap-store.png similarity index 100% rename from docs/setup/images/snap-store.png rename to docs/getting-started/images/snap-store.png diff --git a/docs/get-started/intro-videos.md b/docs/getting-started/introductory-videos.md similarity index 100% rename from docs/get-started/intro-videos.md rename to docs/getting-started/introductory-videos.md diff --git a/docs/get-started/themes.md b/docs/getting-started/preferences.md similarity index 100% rename from docs/get-started/themes.md rename to docs/getting-started/preferences.md diff --git a/docs/index.md b/docs/index.md index 6c7e0f4074..acf35f6029 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,32 +1,24 @@ -# Getting Started +# Overview -Lens is the most powerful IDE for people who need to deal with Kubernetes clusters on a daily basis. It is a standalone application for MacOS, Windows and Linux operating systems. Ensure your clusters are properly setup and configured. Enjoy increased visibility, real time statistics, log streams and hands-on troubleshooting capabilities. With Lens, you can work with your clusters more easily and fast, radically improving productivity and the speed of business. Begin your journey with Lens with these [introductory videos](/get-started/intro-videos/). +Lens is the most powerful Kubernetes IDE on the market. It is a standalone application, and it is available on macOS, Windows, and Linux. Some of the benefits of using Lens include: + +* Ensure your clusters are properly setup and configured. +* Enjoy increased visibility, real time statistics, log streams, and hands-on troubleshooting capabilities. +* Work with your clusters more easily and fast, radically improving productivity and the speed of business. + +Watch this introductory video to see Lens in action: - -## Lens in Action +## Introducing Lens -## Top Extensions +## Downloading Lens -- One -- Two -- Three +[Download Lens](https://github.com/lensapp/lens/releases) for macOS, Windows, or Linux. -## First Steps +## Quickstart -To get the most out of Lens, start by reviewing a few introductory topics: - -[Intro Videos](/get-started/intro-videos/) - Begin your journey with Lens through these introductory videos. - -[Add Clusters](/clusters/add-cluster/) - Add your first Cluster to radically improve productivity and the speed of business. - -[Extension API](/extensions/overview/) - Learn how to write a Lens extension. - - -## Downloads - -[Download Lens IDE](/setup/overview/) - Quickly find the appropriate install for your platform (Windows, macOS and Linux) \ No newline at end of file +Learn to [add clusters](/clusters/add-cluster/) to improve productivity and increase the speed of business. \ No newline at end of file diff --git a/docs/setup/linux.md b/docs/setup/linux.md deleted file mode 100644 index 252ad26899..0000000000 --- a/docs/setup/linux.md +++ /dev/null @@ -1,19 +0,0 @@ -# Lens on Linux - -## Installation - -See the [Download Lens](https://github.com/lensapp/lens/releases) page for a complete list of available installation options. - - - -### Snap - -Lens is officially distributed as a Snap package in the [Snap Store](https://snapcraft.io/store): - -[![Get it from the Snap Store](images/snap-store.png)](https://snapcraft.io/kontena-lens) - -You can install it by running: - -```bash -sudo snap install kontena-lens --classic -``` \ No newline at end of file diff --git a/docs/setup/macos.md b/docs/setup/macos.md deleted file mode 100644 index e411c8f54a..0000000000 --- a/docs/setup/macos.md +++ /dev/null @@ -1,9 +0,0 @@ -# Lens on macOS - -## Installation - -1. [Download Lens](https://github.com/lensapp/lens/releases) for macOS. -2. Open the browser's download list and locate the downloaded archive. -3. Select the 'magnifying glass' icon to open the archive in Finder. -4. Double-click `Lens-{version}.dmg` and drag `Lens.app` to the `Applications` folder, making it available in the macOS Launchpad. -5. Add Lens to your Dock by right-clicking on the icon to bring up the context menu and choosing **Options**, **Keep in Dock**. \ No newline at end of file diff --git a/docs/setup/network.md b/docs/setup/network.md deleted file mode 100644 index b31aea55a2..0000000000 --- a/docs/setup/network.md +++ /dev/null @@ -1,8 +0,0 @@ -# Network Connections in Lens - -Lens is built on top of Electron and benefits from all the networking stack capabilities of Chromium. - - -## Proxy server support - -... diff --git a/docs/setup/overview.md b/docs/setup/overview.md deleted file mode 100644 index ca0025d6ca..0000000000 --- a/docs/setup/overview.md +++ /dev/null @@ -1,23 +0,0 @@ -# Setting up Lens - -Getting up and running with Lens is quick and easy. It is a small download so you can install in a matter of minutes and give Lens a try. - - -## Cross platform - -Lens is the most powerful IDE for people who need to deal with Kubernetes clusters on a daily basis which runs on the macOS, Linux, and Windows operating systems. - -Follow the platform-specific guides below: - -* [Linux](/setup/linux/) -* [macOS](/setup/macos/) -* [Windows](/setup/windows/) - -Lens is lightweight and should run on most available hardware and platform versions. You can review the [System Requirements](/supporting/requirements/) to check if your computer configuration is supported. - - -## Update cadence - -Lens releases a new version each month with new features and important bug fixes. Lens supports auto updating and you will be prompted to install the new release when it becomes available! - -To stay current with the Lens features, you can review the [release notes](https://github.com/lensapp/lens/releases). \ No newline at end of file diff --git a/docs/setup/windows.md b/docs/setup/windows.md deleted file mode 100644 index f804eeda3d..0000000000 --- a/docs/setup/windows.md +++ /dev/null @@ -1,7 +0,0 @@ -# Lens on Windows - -## Installation - -1. Download the [Lens installer](https://github.com/lensapp/lens/releases) for Windows. -2. Once it is downloaded, run the installer `Lens-Setup-{version}.exe`. This will only take a minute. -3. By default, Lens is installed under `C:\users\{username}\AppData\Local\Programs\Lens`. \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 200dff7131..f699850664 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -9,21 +9,14 @@ copyright: Copyright © 2020 Mirantis Inc. Date: Thu, 29 Oct 2020 15:17:56 -0700 Subject: [PATCH 2/5] Updated downloading-lens and preferences --- docs/getting-started/downloading-lens.md | 2 +- docs/getting-started/preferences.md | 18 +++++++++++++++++- docs/index.md | 2 +- 3 files changed, 19 insertions(+), 3 deletions(-) diff --git a/docs/getting-started/downloading-lens.md b/docs/getting-started/downloading-lens.md index 3fc5365052..e84f1204f5 100644 --- a/docs/getting-started/downloading-lens.md +++ b/docs/getting-started/downloading-lens.md @@ -56,4 +56,4 @@ To stay current with the Lens features, you can review the [release notes](https ## Quickstart -Learn to [add clusters](/clusters/add-cluster/) to improve productivity and increase the speed of business. \ No newline at end of file +Get up and running quickly by learning to [add clusters](/clusters/add-cluster/). \ No newline at end of file diff --git a/docs/getting-started/preferences.md b/docs/getting-started/preferences.md index cd7ca9d1c3..bbbd55ddf9 100644 --- a/docs/getting-started/preferences.md +++ b/docs/getting-started/preferences.md @@ -1,7 +1,23 @@ -# Color Themes +# Preferences + + +## Color Themes Color themes let you modify the colors in Lens user interface to suit your preferences and work environment. In Lens, open the Preferences with **File** > **Preferences**. (**Code** > **Preferences** on macOS) and 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. + + +### 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. +![Disable Telemetry & Usage Tracking](images/disabled-telemetry-usage-tracking.png) + diff --git a/docs/index.md b/docs/index.md index acf35f6029..090d75bde4 100644 --- a/docs/index.md +++ b/docs/index.md @@ -21,4 +21,4 @@ Watch this introductory video to see Lens in action: ## Quickstart -Learn to [add clusters](/clusters/add-cluster/) to improve productivity and increase the speed of business. \ No newline at end of file +Get up and running quickly by learning to [add clusters](/clusters/add-cluster/). \ No newline at end of file From e768dc8e2cb875de2f2af910b5bbff20e31c0ec7 Mon Sep 17 00:00:00 2001 From: Paul Williams Date: Thu, 29 Oct 2020 15:26:15 -0700 Subject: [PATCH 3/5] Added system requirements to downloading-lens.md --- docs/getting-started/downloading-lens.md | 5 +++++ mkdocs.yml | 2 +- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/getting-started/downloading-lens.md b/docs/getting-started/downloading-lens.md index e84f1204f5..dc75a8ac22 100644 --- a/docs/getting-started/downloading-lens.md +++ b/docs/getting-started/downloading-lens.md @@ -3,6 +3,11 @@ Lens is lightweight and simple to install. You'll be up and running in just a few minutes. +## System requirements + +You can review the [System Requirements](/supporting/requirements/) to check if your computer configuration is supported. + + ## macOS 1. [Download Lens](https://github.com/lensapp/lens/releases) for macOS. diff --git a/mkdocs.yml b/mkdocs.yml index f699850664..024aebf6a3 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -12,7 +12,7 @@ nav: - Getting started: - Downloading Lens: getting-started/downloading-lens.md - Preferences: getting-started/preferences.md - - Introductory videos: getting-started/introductory-videos + - Introductory videos: getting-started/introductory-videos.md - Clusters: - Adding clusters: clusters/adding-clusters.md - Removing cluster: clusters/removing-clusters.md From 8b0e02b8aa61991fe868ac65319bb52f2b1a885d Mon Sep 17 00:00:00 2001 From: Paul Williams Date: Thu, 29 Oct 2020 15:35:45 -0700 Subject: [PATCH 4/5] Fixed various page and section headings --- docs/clusters/adding-clusters.md | 2 +- docs/clusters/removing-clusters.md | 2 +- docs/getting-started/downloading-lens.md | 2 +- docs/getting-started/preferences.md | 4 ++-- docs/index.md | 6 +++--- 5 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/clusters/adding-clusters.md b/docs/clusters/adding-clusters.md index 15381d22c1..ded093c1a6 100644 --- a/docs/clusters/adding-clusters.md +++ b/docs/clusters/adding-clusters.md @@ -1,4 +1,4 @@ -# Add Cluster +# 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. diff --git a/docs/clusters/removing-clusters.md b/docs/clusters/removing-clusters.md index dcdfbd975d..0a38213531 100644 --- a/docs/clusters/removing-clusters.md +++ b/docs/clusters/removing-clusters.md @@ -1,4 +1,4 @@ -# Remove Cluster +# Removing clusters You can remove a Lens Clusters from your cluster list using the context-menu of the cluster item in the left-side menu. By right-clicking the cluster of choice you can hit the `Remove` button to delete it from your list. diff --git a/docs/getting-started/downloading-lens.md b/docs/getting-started/downloading-lens.md index dc75a8ac22..dc732d104e 100644 --- a/docs/getting-started/downloading-lens.md +++ b/docs/getting-started/downloading-lens.md @@ -5,7 +5,7 @@ Lens is lightweight and simple to install. You'll be up and running in just a fe ## System requirements -You can review the [System Requirements](/supporting/requirements/) to check if your computer configuration is supported. +Review the [System Requirements](/supporting/requirements/) to check if your computer configuration is supported. ## macOS diff --git a/docs/getting-started/preferences.md b/docs/getting-started/preferences.md index bbbd55ddf9..96232b5f6b 100644 --- a/docs/getting-started/preferences.md +++ b/docs/getting-started/preferences.md @@ -1,7 +1,7 @@ # Preferences -## Color Themes +## Color themes Color themes let you modify the colors in Lens user interface to suit your preferences and work environment. @@ -9,7 +9,7 @@ In Lens, open the Preferences with **File** > **Preferences**. (**Code** > **Pre ![Color Theme](images/color-theme.png) -## Telemetry & Usage Tracking +## 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. diff --git a/docs/index.md b/docs/index.md index 090d75bde4..9524e66967 100644 --- a/docs/index.md +++ b/docs/index.md @@ -2,9 +2,9 @@ Lens is the most powerful Kubernetes IDE on the market. It is a standalone application, and it is available on macOS, Windows, and Linux. Some of the benefits of using Lens include: -* Ensure your clusters are properly setup and configured. -* Enjoy increased visibility, real time statistics, log streams, and hands-on troubleshooting capabilities. -* Work with your clusters more easily and fast, radically improving productivity and the speed of business. +* Confidence that your clusters are properly setup and configured. +* Increased visibility, real time statistics, log streams, and hands-on troubleshooting capabilities. +* The ability to work with your clusters quickly and easily, radically improving productivity and the speed of business. Watch this introductory video to see Lens in action: From 6dfa38e369ef56a4cedbddab8f03fc450f817889 Mon Sep 17 00:00:00 2001 From: Paul Williams Date: Thu, 29 Oct 2020 15:54:22 -0700 Subject: [PATCH 5/5] Changed name of docs to Lens Documentation --- mkdocs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index 024aebf6a3..90db614fe9 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,4 +1,4 @@ -site_name: Lens - The Kubernetes IDE Documentation +site_name: Lens Documentation site_description: Documentation for Lens IDE. The only system you’ll ever need to take control of your Kubernetes clusters. It's open source and free. Download it today! site_author: Mirantis, Inc. site_url: https://docs.k8slens.dev