Docs change for Zowe Explorer plug-in for IntelliJ IDEA

Signed-off-by: Uladzislau <leksilonchikk@gmail.com>
zowe · Sep 10, 2024 · 7b2bcca · 7b2bcca
1 parent 071c1a5
commit 7b2bcca
Show file tree

Hide file tree

Showing 166 changed files with 1,065 additions and 356 deletions.
diff --git a/docs/appendix/zowe-glossary.md b/docs/appendix/zowe-glossary.md
@@ -51,11 +51,11 @@ Provides a command-line interface that lets you interact with the mainframe remo
 
 Includes all the Zowe projects, or components, that are installed on the user's PC. Also known as *Zowe client-side projects* or *Zowe client-side components*.
 
-Examples include Zowe CLI, Zowe Explorer for Visual Studio Code, Zowe Explorer for IntelliJ, and Zowe Client SDKs.
+Examples include Zowe CLI, Zowe Explorer for Visual Studio Code, Zowe Explorer for IntelliJ IDEA, and Zowe Client SDKs.
 
 ### Zowe Client SDKs
 
-Allow extenders to build applications on top of existing programmatic APIs such as z/OSMF. Currently supported client SDKs include Node.js (core), Kotlin/z/OSMF, Python, Swift, and Java.
+Allow extenders to build applications on top of existing programmatic APIs such as z/OSMF. Currently supported client SDKs include Node.js (core), Kotlin, Python, Swift, and Java.
 
 ### Zowe Explorer
 
@@ -173,9 +173,9 @@ Provides re-usable and industry-compliant JSON-formatted RMF/SMF data records so
 
 The set of programs (for example, `zwe` command) and utilities (for example, JCL, scripts) which manage the Zowe server configuration and components. The infrastructure standardizes the packaging of components and controls how they are started, stopped, and how configuration is provided to them.
 
-#### Zowe IntelliJ Plug-in
+#### Zowe Explorer plug-in for IntelliJ IDEA
 
-Uses the IntelliJ IDE to provide the ability to work with z/OS data sets and USS files, and to explore and manage JES jobs.
+Uses the IntelliJ IDEA platform IDEs to provide the ability to work with z/OS data sets, USS files, to explore and manage JES jobs and to work with TSO Console.
 
 #### Zowe Launcher
 

diff --git a/docs/contribute/roadmap-contribute.md b/docs/contribute/roadmap-contribute.md
@@ -52,7 +52,7 @@ Check out the contribution guidelines for different components and squads to lea
   - [Zowe Application Framework](https://github.com/zowe/zlux)  
   - [Zowe Explorer](https://github.com/zowe/zowe-explorer-vscode/blob/master/CONTRIBUTING.md)
   - [Zowe Client SDKs](https://github.com/zowe/zowe-cli/blob/master/docs/SDKGuidelines.md)
-  - [Zowe IntelliJ plug-in](https://github.com/zowe/zowe-explorer-intellij/blob/main/CONTRIBUTING.md)
+  - [Zowe Explorer plug-in for IntelliJ IDEA](https://github.com/zowe/zowe-explorer-intellij/blob/main/CONTRIBUTING.md)
   - [Zowe Docs](./contributing)
 
 ## Promote Zowe

diff --git a/docs/extend/extend-sdks.md b/docs/extend/extend-sdks.md
@@ -8,6 +8,7 @@ The functionality is currently limited to the interfaces provided by IBM z/OSMF.
 
 For detailed contribution guidelines, see the following documents:
 - [Node.js SDK guidelines](https://github.com/zowe/zowe-cli/blob/master/docs/SDKGuidelines.md)
+- [Kotlin SDK guidelines](https://github.com/zowe/zowe-explorer-intellij/blob/main/CONTRIBUTING.md)
 - **Coming soon! Python SDK guidelines**
 
 ## Community resources 
@@ -16,4 +17,3 @@ For detailed contribution guidelines, see the following documents:
 - You can join one of the [Zowe CLI squad meetings](https://lists.openmainframeproject.org/g/zowe-dev/calendar) to discuss Zowe SDKs issues and contibute to Zowe SDKs.
 - Read a series of [blogs about Zowe](https://medium.com/zowe) on Medium to explore use cases, best practices, and more. 
 - Look for discussion on Zowe topics on the [Open Mainframe Project Community Forums](https://community.openmainframeproject.org/c/zowe).
-
diff --git a/docs/getting-started/install-zowe-sdks.md b/docs/getting-started/install-zowe-sdks.md
@@ -20,7 +20,7 @@ The following SDKs are available.
 
 For detailed SDK documentation, see the following:
 - [Zowe Client Java SDK](https://github.com/Zowe-Java-SDK)
-- [Zowe Client Kotlin SDK](https://for-mainframe.github.io/r2z/)
+- [Zowe Client Kotlin SDK](https://zowe.github.io/zowe-client-kotlin-sdk/)
 - [Zowe Client Node.js SDK](https://docs.zowe.org/stable/typedoc/index.html)
 - [Zowe Client Python SDK](https://zowe-client-python-sdk.readthedocs.io/en/latest/) *technical preview*
 - [Zowe SDK Sample Scripts](https://github.com/zowe/zowe-sdk-sample-scripts/)
@@ -55,38 +55,7 @@ implementation group: 'org.zowe.client.java.sdk', name: 'zowe-client-java-sdk',
 
 Requires Java Runtime Environment (JRE) 17.
 
-To install this library in your project, use a build tool such as Maven, Gradle, or Ant. Get the necessary artifacts from the [Kotlin SDK repository](https://zowe.jfrog.io/artifactory/libs-release/org/zowe/sdk/zowe-kotlin-sdk/).
-
-If you add the Kotlin SDK as a dependency to your project, Maven or Gradle automatically downloads any additional dependencies needed to use the SDK.
-
-
-:::note
-
-You must download the `JAR` file and install it into your local repository using Maven or Gradle.
-
-:::
-
-For a Maven project, add the SDK as a dependency by updating the `pom.xml` file:
-
-```
-<dependency>
-  <groupId>org.zowe.sdk</groupId>
-  <artifactId>zowe-kotlin-sdk</artifactId>
-  <version>{version}</version>
-</dependency>
-```
-
-For a Gradle project, add the SDK as a dependency by updating the `build.gradle.kts` file:
-
-```
-implementation("org.zowe.sdk:zowe-kotlin-sdk:$version")
-```
-
-To use:
-
-```
-import org.zowe.kotlinsdk
-```
+For detailed information about how to install the library, refer to [the official installation guide for Zowe Client Kotlin SDK](https://zowe.github.io/zowe-client-kotlin-sdk/#installation)
 
 ### Node.js
 

diff --git a/docs/getting-started/overview.md b/docs/getting-started/overview.md
@@ -214,6 +214,7 @@ The Zowe Client SDKs consist of programmatic APIs that you can use to build clie
 
 - Zowe Node.js Client SDK
 - Zowe Java Client SDK
+- Zowe Kotlin Client SDK
 - Zowe Python Client SDK
 
 For more information, see [Using the Zowe SDKs](../user-guide/sdks-using.md).
@@ -268,21 +269,21 @@ ZEBRA Provides re-usable and industry compliant JSON formatted RMF/SMF data reco
 
 For more information, see the [ZEBRA documentation](https://github.com/zowe/zebra/tree/main/Documentation).
 
-### Zowe IntelliJ Plug-in
+### Zowe Explorer plug-in for IntelliJ IDEA
 
-Zowe IntelliJ plug-in for Intellij-based IDEs is a smart and interactive mainframe code editing tool that allows you to browse, edit, and create data on z/OS via z/OSMF REST API. 
+Zowe Explorer plug-in for IntelliJ IDEA is a smart and interactive mainframe code editing tool that allows you to browse, edit, and create data on z/OS via z/OSMF REST API. 
 
-Zowe IntelliJ plug-in helps you to: 
-- Start working with z/OS easily with no complex configurations.
-- Organize datasets on z/OS, files on USS into working sets.
-- Allocate datasets, create members, files and directories with different permissions.
-- Perform operations like renaming, copying and moving data in a modern way.
-- Edit datasets, files and members. Smart auto-save keeps your content both in the editor and on the mainframe in-sync.
-- Create multiple connections to different z/OS systems.
-- Perform all available operations with jobs.
-- Highlight all IntelliJ supported languages automatically and recognize them once opened from the mainframe.
+The plug-in helps to: 
+- Start working with z/OS easily with no complex configurations
+- Organize datasets on z/OS, files on USS into working sets
+- Allocate datasets, create members, files and directories with different permissions
+- Perform operations like renaming, copying and moving data in a modern way
+- Edit datasets, files and members. Smart auto-save keeps your content both in the editor and on the mainframe in-sync
+- Create multiple connections to different z/OS systems
+- Perform all available operations with jobs
+- Work with TSO Console directly in the IDE
 
-For more information, see [Using Zowe IntelliJ plug-in](../user-guide/intellij-using.md).
+To see more about it, you can start with [Zowe Explorer plug-in for IntelliJ IDEA use cases](../user-guide/intellij-use-cases.md).
 
 ## Zowe Bill of Materials
 

diff --git a/docs/getting-started/zowe_faq.md b/docs/getting-started/zowe_faq.md
@@ -34,7 +34,7 @@ Zowe technology can be used by a variety of mainframe IT and non-IT professional
 
 <summary></summary>
 
-Zowe consists of several components. The primary languages for API Mediation Layer are Java and JavaScript. Zowe CLI, Explorer for VSCode and Desktop are written in TypeScript. Explorer for IntelliJ is written in Kotlin, ZSS is written in C, while the cross memory server is written in metal C.
+Zowe consists of several components. The primary languages for API Mediation Layer are Java and JavaScript. Zowe CLI, Explorer for VSCode and Desktop are written in TypeScript. Zowe Explorer plug-in for IntelliJ IDEA is written in Kotlin, ZSS is written in C, while the cross memory server is written in metal C.
 
 </details>
 
@@ -499,19 +499,19 @@ As a developer, you may contribute to Zowe Explorer in the following ways:
 
 </details>
 
-## Zowe IntelliJ plug-in FAQ
+## Zowe Explorer plug-in for IntelliJ IDEA FAQ
 
-### Why might I use Zowe IntelliJ plug-in versus a traditional ISPF interface to perform mainframe tasks?
+### Why might I use the plug-in versus a traditional ISPF interface to perform mainframe tasks?
 
 <details className="zowe-faq">
 
 <summary></summary>
 
-Zowe IntelliJ plug-in allows you to access and work with data sets, members and jobs directly from your IntelliJ-based IDE.
+Zowe Explorer plug-in for IntelliJ IDEA allows you to access and work with data sets, members and jobs directly from your IntelliJ-based IDE, such as IntelliJ IDEA, PyCharm, Android Studio, etc.
 
 </details>
 
-### How can I get started with Zowe IntelliJ plug-in?
+### How can I get started with Zowe Explorer plug-in for IntelliJ IDEA?
 
 <details className="zowe-faq">
 
@@ -521,42 +521,32 @@ Install the plug-in in your IntelliJ-based IDE directly from marketplace or down
 
 </details>
 
-### Where can I use Zowe IntelliJ plug-in?
+### Where can I use Zowe Explorer plug-in for IntelliJ IDEA?
 
 <details className="zowe-faq">
 
 <summary></summary>
 
-You can use it in any IntelliJ-based IDE. 
+You can use it in any IntelliJ-based IDE, such as IntelliJ IDEA, PyCharm, Android Studio, etc.
 
 </details>
 
-### How do I get help with using Zowe IntelliJ plug-in?
+### How do I get help with using Zowe Explorer plug-in for IntelliJ IDEA?
 
 <details className="zowe-faq">
 
 <summary></summary>
 
-You can read detailed user guide and find any information you need [here](https://plugins.jetbrains.com/plugin/18688-zowe-explorer/user-guide). Also, you can ask any questions in the Zowe Slack channel [#zowe-explorer-intellij](https://openmainframeproject.slack.com/archives/C020BGPSU0M).
+You can start with [use cases](../user-guide/intellij-use-cases.md) section to learn about use cases and to learn how to install and use the plug-in. Also, you can ask any questions in our [Zowe Slack channel (#zowe-explorer-intellij)](https://openmainframeproject.slack.com/archives/C020BGPSU0M).
 
 </details>
 
-### How can I create, edit and delete z/OSMF connection?
+### How can I contribute to Zowe Explorer plug-in for IntelliJ IDEA?
 
 <details className="zowe-faq">
 
 <summary></summary>
 
-To create a connection, expand plug-in panel on an IDE sidebar (on the right side of your screen) and press the "wrench" pictogram, or go to **File** -> **Settings** (CTRL+ALT+S), select **Zowe Explorer (Zowe IntelliJ plugin)** and then switch to the **z/OSMF connection** tab. Press the “+” button and fill inn all necessary fields.
-
-</details>
-
-### How can I contribute to Zowe IntelliJ plug-in?
-
-<details className="zowe-faq">
-
-<summary></summary>
-
-If you have something to introduce but there is no related issue in the project repo, then you can either create the issue by yourself or contact us to help you with it. See more information in the [CONTRIBUTION.md](https://github.com/zowe/zowe-explorer-intellij/blob/main/CONTRIBUTING.md) file.  
+If you have ideas on how to improve the plug-in, or have an issue/bug fix in mind, visit the [contribution guide](https://github.com/zowe/zowe-explorer-intellij/blob/main/CONTRIBUTING.md). Also, you can ask for help in our [Zowe Slack channel (#zowe-explorer-intellij)](https://openmainframeproject.slack.com/archives/C020BGPSU0M).
 
 </details>
diff --git a/docs/images/intellij/actions_download_artifact.png b/docs/images/intellij/actions_download_artifact.png
diff --git a/docs/images/intellij/actions_select_build.png b/docs/images/intellij/actions_select_build.png
diff --git a/docs/images/intellij/actions_select_workflow.png b/docs/images/intellij/actions_select_workflow.png
diff --git a/docs/images/intellij/connection_create.gif b/docs/images/intellij/connection_create.gif
diff --git a/docs/images/intellij/connection_zowe_config_v2.gif b/docs/images/intellij/connection_zowe_config_v2.gif
diff --git a/docs/images/intellij/copy_cut_member_copy.png b/docs/images/intellij/copy_cut_member_copy.png
diff --git a/docs/images/intellij/copy_cut_member_copy_dialog.png b/docs/images/intellij/copy_cut_member_copy_dialog.png
diff --git a/docs/images/intellij/copy_cut_member_copy_result.png b/docs/images/intellij/copy_cut_member_copy_result.png
diff --git a/docs/images/intellij/copy_cut_member_copy_select_paste.png b/docs/images/intellij/copy_cut_member_copy_select_paste.png
diff --git a/docs/images/intellij/copy_cut_member_cut.png b/docs/images/intellij/copy_cut_member_cut.png
diff --git a/docs/images/intellij/copy_cut_member_cut_dialog.png b/docs/images/intellij/copy_cut_member_cut_dialog.png
diff --git a/docs/images/intellij/copy_cut_member_cut_moving_confirmation.png b/docs/images/intellij/copy_cut_member_cut_moving_confirmation.png
diff --git a/docs/images/intellij/copy_cut_member_cut_result_source.png b/docs/images/intellij/copy_cut_member_cut_result_source.png
diff --git a/docs/images/intellij/copy_cut_member_cut_select_paste.png b/docs/images/intellij/copy_cut_member_cut_select_paste.png
diff --git a/docs/images/intellij/copy_cut_member_to_uss_copy_dialog.png b/docs/images/intellij/copy_cut_member_to_uss_copy_dialog.png
diff --git a/docs/images/intellij/copy_cut_member_to_uss_copy_result.png b/docs/images/intellij/copy_cut_member_to_uss_copy_result.png
diff --git a/docs/images/intellij/copy_cut_pds_to_uss_cross_copy.png b/docs/images/intellij/copy_cut_pds_to_uss_cross_copy.png
diff --git a/docs/images/intellij/copy_cut_pds_to_uss_cross_copy_dialog.png b/docs/images/intellij/copy_cut_pds_to_uss_cross_copy_dialog.png
diff --git a/docs/images/intellij/copy_cut_pds_to_uss_cross_copy_paste.png b/docs/images/intellij/copy_cut_pds_to_uss_cross_copy_paste.png
diff --git a/docs/images/intellij/copy_cut_pds_to_uss_cross_copy_result.png b/docs/images/intellij/copy_cut_pds_to_uss_cross_copy_result.png
diff --git a/docs/images/intellij/copy_cut_pds_to_uss_cut.png b/docs/images/intellij/copy_cut_pds_to_uss_cut.png
diff --git a/docs/images/intellij/copy_cut_pds_to_uss_cut_paste.png b/docs/images/intellij/copy_cut_pds_to_uss_cut_paste.png
diff --git a/docs/images/intellij/copy_cut_pds_to_uss_cut_result.png b/docs/images/intellij/copy_cut_pds_to_uss_cut_result.png
diff --git a/docs/images/intellij/copy_cut_pds_to_uss_moving_dialog.png b/docs/images/intellij/copy_cut_pds_to_uss_moving_dialog.png
diff --git a/docs/images/intellij/copy_cut_ps_to_pds_copy.png b/docs/images/intellij/copy_cut_ps_to_pds_copy.png
diff --git a/docs/images/intellij/copy_cut_ps_to_pds_copy_conflicts.png b/docs/images/intellij/copy_cut_ps_to_pds_copy_conflicts.png
diff --git a/docs/images/intellij/copy_cut_ps_to_pds_copy_dialog.png b/docs/images/intellij/copy_cut_ps_to_pds_copy_dialog.png
diff --git a/docs/images/intellij/copy_cut_ps_to_pds_copy_result.png b/docs/images/intellij/copy_cut_ps_to_pds_copy_result.png
diff --git a/docs/images/intellij/copy_cut_uss_to_pds_cut.png b/docs/images/intellij/copy_cut_uss_to_pds_cut.png
diff --git a/docs/images/intellij/copy_cut_uss_to_pds_cut_content_before.png b/docs/images/intellij/copy_cut_uss_to_pds_cut_content_before.png
diff --git a/docs/images/intellij/copy_cut_uss_to_pds_cut_paste.png b/docs/images/intellij/copy_cut_uss_to_pds_cut_paste.png
diff --git a/docs/images/intellij/copy_cut_uss_to_pds_cut_placing_warning.png b/docs/images/intellij/copy_cut_uss_to_pds_cut_placing_warning.png
diff --git a/docs/images/intellij/copy_cut_uss_to_pds_cut_result.png b/docs/images/intellij/copy_cut_uss_to_pds_cut_result.png
diff --git a/docs/images/intellij/copy_cut_uss_to_pds_moving_dialog.png b/docs/images/intellij/copy_cut_uss_to_pds_moving_dialog.png
diff --git a/docs/images/intellij/copy_cut_uss_to_uss_copy_select_paste.png b/docs/images/intellij/copy_cut_uss_to_uss_copy_select_paste.png
diff --git a/docs/images/intellij/copy_cut_uss_to_uss_cut.png b/docs/images/intellij/copy_cut_uss_to_uss_cut.png
diff --git a/docs/images/intellij/copy_cut_uss_to_uss_cut_result.png b/docs/images/intellij/copy_cut_uss_to_uss_cut_result.png
diff --git a/docs/images/intellij/copy_cut_uss_to_uss_cut_select_paste.png b/docs/images/intellij/copy_cut_uss_to_uss_cut_select_paste.png
diff --git a/docs/images/intellij/copy_cut_uss_to_uss_moving_dialog.png b/docs/images/intellij/copy_cut_uss_to_uss_moving_dialog.png
diff --git a/docs/images/intellij/copy_mem_to_uss.gif b/docs/images/intellij/copy_mem_to_uss.gif
diff --git a/docs/images/intellij/create_connection_plus.png b/docs/images/intellij/create_connection_plus.png
diff --git a/docs/images/intellij/create_connection_settings.png b/docs/images/intellij/create_connection_settings.png
diff --git a/docs/images/intellij/create_connection_zowe_config_file.gif b/docs/images/intellij/create_connection_zowe_config_file.gif
diff --git a/docs/images/intellij/create_connection_zowe_config_plus.gif b/docs/images/intellij/create_connection_zowe_config_plus.gif
diff --git a/docs/images/intellij/create_plugins_connection_or_zowe_config.png b/docs/images/intellij/create_plugins_connection_or_zowe_config.png
diff --git a/docs/images/intellij/cross_system_copy.gif b/docs/images/intellij/cross_system_copy.gif
diff --git a/docs/images/intellij/datasets_sort.png b/docs/images/intellij/datasets_sort.png
diff --git a/docs/images/intellij/datasets_sort_result.png b/docs/images/intellij/datasets_sort_result.png
diff --git a/docs/images/intellij/download_intellij.png b/docs/images/intellij/download_intellij.png
diff --git a/docs/images/intellij/download_plugin_marketplace.png b/docs/images/intellij/download_plugin_marketplace.png
diff --git a/docs/images/intellij/download_plugin_releases.png b/docs/images/intellij/download_plugin_releases.png
diff --git a/docs/images/intellij/download_uss_copy.png b/docs/images/intellij/download_uss_copy.png
diff --git a/docs/images/intellij/download_uss_copy_final_dialog.png b/docs/images/intellij/download_uss_copy_final_dialog.png
diff --git a/docs/images/intellij/download_uss_copy_name_conflicts.png b/docs/images/intellij/download_uss_copy_name_conflicts.png
diff --git a/docs/images/intellij/download_uss_copy_paste.png b/docs/images/intellij/download_uss_copy_paste.png
diff --git a/docs/images/intellij/download_uss_copy_result.png b/docs/images/intellij/download_uss_copy_result.png
diff --git a/docs/images/intellij/download_uss_copy_security_warning.png b/docs/images/intellij/download_uss_copy_security_warning.png
diff --git a/docs/images/intellij/download_uss_copy_single_conflict.png b/docs/images/intellij/download_uss_copy_single_conflict.png
diff --git a/docs/images/intellij/get_plugin.png b/docs/images/intellij/get_plugin.png
diff --git a/docs/images/intellij/install_from_bin_from_disk.png b/docs/images/intellij/install_from_bin_from_disk.png
diff --git a/docs/images/intellij/install_from_bin_restart.png b/docs/images/intellij/install_from_bin_restart.png
diff --git a/docs/images/intellij/install_from_bin_search_for_zip.png b/docs/images/intellij/install_from_bin_search_for_zip.png
diff --git a/docs/images/intellij/install_in_intellij_after_install.png b/docs/images/intellij/install_in_intellij_after_install.png
diff --git a/docs/images/intellij/install_in_intellij_corner_change.png b/docs/images/intellij/install_in_intellij_corner_change.png
diff --git a/docs/images/intellij/install_in_intellij_marketplace.png b/docs/images/intellij/install_in_intellij_marketplace.png
diff --git a/docs/images/intellij/install_in_intellij_plugins.png b/docs/images/intellij/install_in_intellij_plugins.png
diff --git a/docs/images/intellij/install_in_intellij_restart.png b/docs/images/intellij/install_in_intellij_restart.png
diff --git a/docs/images/intellij/install_in_intellij_search_and_install.png b/docs/images/intellij/install_in_intellij_search_and_install.png
diff --git a/docs/images/intellij/intellij-install.gif b/docs/images/intellij/intellij-install.gif
diff --git a/docs/images/intellij/intellij_open_uss_file.png b/docs/images/intellij/intellij_open_uss_file.png
diff --git a/docs/images/intellij/jes_jcl_edit.png b/docs/images/intellij/jes_jcl_edit.png
diff --git a/docs/images/intellij/jes_jcl_edit_after_refresh.png b/docs/images/intellij/jes_jcl_edit_after_refresh.png
diff --git a/docs/images/intellij/jes_jcl_edit_console.png b/docs/images/intellij/jes_jcl_edit_console.png
diff --git a/docs/images/intellij/jes_jcl_edit_refresh.png b/docs/images/intellij/jes_jcl_edit_refresh.png
diff --git a/docs/images/intellij/jes_jcl_edit_run_button.png b/docs/images/intellij/jes_jcl_edit_run_button.png
diff --git a/docs/images/intellij/jes_purge_click_purge.png b/docs/images/intellij/jes_purge_click_purge.png
diff --git a/docs/images/intellij/jes_purge_dialog.png b/docs/images/intellij/jes_purge_dialog.png
diff --git a/docs/images/intellij/jes_purge_job_create_filter.png b/docs/images/intellij/jes_purge_job_create_filter.png
diff --git a/docs/images/intellij/jes_purge_job_filter_dialog.png b/docs/images/intellij/jes_purge_job_filter_dialog.png
diff --git a/docs/images/intellij/jes_purge_success_notification.png b/docs/images/intellij/jes_purge_success_notification.png
diff --git a/docs/images/intellij/jes_sort.png b/docs/images/intellij/jes_sort.png
diff --git a/docs/images/intellij/jes_sort_sorted.png b/docs/images/intellij/jes_sort_sorted.png
diff --git a/docs/images/intellij/jes_spool_console.png b/docs/images/intellij/jes_spool_console.png
diff --git a/docs/images/intellij/jes_spool_console_shown.png b/docs/images/intellij/jes_spool_console_shown.png
diff --git a/docs/images/intellij/jes_spool_view.png b/docs/images/intellij/jes_spool_view.png
diff --git a/docs/images/intellij/jes_spool_view_editor.png b/docs/images/intellij/jes_spool_view_editor.png
diff --git a/docs/images/intellij/jes_spool_view_reveal.png b/docs/images/intellij/jes_spool_view_reveal.png
diff --git a/docs/images/intellij/jes_status.png b/docs/images/intellij/jes_status.png
diff --git a/docs/images/intellij/move_mem_to_ds.gif b/docs/images/intellij/move_mem_to_ds.gif
diff --git a/docs/images/intellij/move_uss_folder_to_uss_folder.gif b/docs/images/intellij/move_uss_folder_to_uss_folder.gif
diff --git a/docs/images/intellij/move_uss_to_pds.gif b/docs/images/intellij/move_uss_to_pds.gif
diff --git a/docs/images/intellij/pds_copy_move_ds.gif b/docs/images/intellij/pds_copy_move_ds.gif
diff --git a/docs/images/intellij/pds_move_zos_to_uss.gif b/docs/images/intellij/pds_move_zos_to_uss.gif
diff --git a/docs/images/intellij/plugin_all_configurations.png b/docs/images/intellij/plugin_all_configurations.png
diff --git a/docs/images/intellij/plugin_create_dataset.png b/docs/images/intellij/plugin_create_dataset.png
diff --git a/docs/images/intellij/plugin_create_dataset_fields.png b/docs/images/intellij/plugin_create_dataset_fields.png
diff --git a/docs/images/intellij/plugin_create_dataset_ok.png b/docs/images/intellij/plugin_create_dataset_ok.png
diff --git a/docs/images/intellij/plugin_create_mask_or_skip.png b/docs/images/intellij/plugin_create_mask_or_skip.png
diff --git a/docs/images/intellij/plugin_dataset_presets.png b/docs/images/intellij/plugin_dataset_presets.png
diff --git a/docs/images/intellij/plugin_open_settings.png b/docs/images/intellij/plugin_open_settings.png
diff --git a/docs/images/intellij/plugin_other_settings.png b/docs/images/intellij/plugin_other_settings.png
diff --git a/docs/images/intellij/plugin_save_before_close.png b/docs/images/intellij/plugin_save_before_close.png
diff --git a/docs/images/intellij/plugin_sync_button.png b/docs/images/intellij/plugin_sync_button.png
diff --git a/docs/images/intellij/select_compatibility_and_channel.png b/docs/images/intellij/select_compatibility_and_channel.png
diff --git a/docs/images/intellij/tso_cli.gif b/docs/images/intellij/tso_cli.gif
diff --git a/docs/images/intellij/tso_console_create.png b/docs/images/intellij/tso_console_create.png
diff --git a/docs/images/intellij/tso_console_created_console.png b/docs/images/intellij/tso_console_created_console.png
diff --git a/docs/images/intellij/tso_console_dialog.png b/docs/images/intellij/tso_console_dialog.png
diff --git a/docs/images/intellij/tso_sessions_add.png b/docs/images/intellij/tso_sessions_add.png
diff --git a/docs/images/intellij/tso_sessions_add_dialog.png b/docs/images/intellij/tso_sessions_add_dialog.png
diff --git a/docs/images/intellij/tso_sessions_created.png b/docs/images/intellij/tso_sessions_created.png
diff --git a/docs/images/intellij/tso_sessions_go_to_sessions.png b/docs/images/intellij/tso_sessions_go_to_sessions.png
diff --git a/docs/images/intellij/tso_sessions_wrench.png b/docs/images/intellij/tso_sessions_wrench.png
diff --git a/docs/images/intellij/upload_file_to_pds_copy.png b/docs/images/intellij/upload_file_to_pds_copy.png
diff --git a/docs/images/intellij/upload_file_to_pds_copy_dialog.png b/docs/images/intellij/upload_file_to_pds_copy_dialog.png
diff --git a/docs/images/intellij/upload_file_to_pds_copy_member_truncation.png b/docs/images/intellij/upload_file_to_pds_copy_member_truncation.png
diff --git a/docs/images/intellij/upload_file_to_pds_copy_paste.png b/docs/images/intellij/upload_file_to_pds_copy_paste.png
diff --git a/docs/images/intellij/upload_file_to_pds_copy_result.png b/docs/images/intellij/upload_file_to_pds_copy_result.png
diff --git a/docs/images/intellij/uss_click_properties.png b/docs/images/intellij/uss_click_properties.png
diff --git a/docs/images/intellij/uss_encoding_dialog.png b/docs/images/intellij/uss_encoding_dialog.png
diff --git a/docs/images/intellij/uss_encoding_select_option.png b/docs/images/intellij/uss_encoding_select_option.png
diff --git a/docs/images/intellij/uss_encoding_warning_dialog.png b/docs/images/intellij/uss_encoding_warning_dialog.png
diff --git a/docs/images/intellij/uss_properties_change_owner_perms.png b/docs/images/intellij/uss_properties_change_owner_perms.png
diff --git a/docs/images/intellij/uss_properties_change_owner_perms_ok.png b/docs/images/intellij/uss_properties_change_owner_perms_ok.png
diff --git a/docs/images/intellij/uss_properties_change_owner_perms_select.png b/docs/images/intellij/uss_properties_change_owner_perms_select.png
diff --git a/docs/images/intellij/uss_properties_possible_changes.png b/docs/images/intellij/uss_properties_possible_changes.png
diff --git a/docs/images/intellij/uss_props_general_tab.png b/docs/images/intellij/uss_props_general_tab.png
diff --git a/docs/images/intellij/uss_sort.png b/docs/images/intellij/uss_sort.png
diff --git a/docs/images/intellij/uss_sort_result.png b/docs/images/intellij/uss_sort_result.png
diff --git a/docs/images/intellij/work_with_jes_jobs.gif b/docs/images/intellij/work_with_jes_jobs.gif
diff --git a/docs/images/troubleshoot/intellij/intellij-find-plugin.png b/docs/images/troubleshoot/intellij/intellij-find-plugin.png
diff --git a/docs/images/troubleshoot/intellij/intellij-go-to-plugins.png b/docs/images/troubleshoot/intellij/intellij-go-to-plugins.png
diff --git a/docs/images/troubleshoot/intellij/intellij-troubleshoot-about.png b/docs/images/troubleshoot/intellij/intellij-troubleshoot-about.png
diff --git a/docs/images/troubleshoot/intellij/intellij-troubleshoot-about_dialog.png b/docs/images/troubleshoot/intellij/intellij-troubleshoot-about_dialog.png
diff --git a/docs/troubleshoot/troubleshoot-check-your-zowe-version.md b/docs/troubleshoot/troubleshoot-check-your-zowe-version.md
@@ -99,14 +99,6 @@ Find the version number of your Zowe release in the `manifest.json` file.
 
     An **Editor** tab displays the Zowe Explorer extension's marketplace details. The version number is located next to the Zowe Explorer extension's name.
 
-### Zowe IntelliJ Plug-in
+### Zowe Explorer plug-in for IntelliJ IDEA
 
-1. Open the **File** menu and click **Settings**.
-
-    The **Settings** window opens.
-2. Click **Plugins**, then click **Installed** tab.
-
-    A list of the installed extensions displays.
-3. Search for, and select, `Zowe Explorer`.
-
-    The Zowe Explorer marketplace details display on the right side of the window. The version number is located adjacent to the Zowe Explorer name.
+See the [guide](./troubleshoot-intellij) for instructions.
diff --git a/docs/troubleshoot/troubleshoot-intellij.md b/docs/troubleshoot/troubleshoot-intellij.md
@@ -1,10 +1,39 @@
-# Troubleshooting Zowe IntelliJ plug-in
+# Troubleshooting Zowe Explorer plug-in for IntelliJ IDEA
 
-As a Zowe IntelliJ plug-in user, you may encounter problems with how the plug-in functions.
+As a Zowe Explorer plug-in for IntelliJ IDEA user, you may encounter problems both with the plug-in and the IntelliJ IDEA platform. Our support is open for any type of issues, related to this client-side component. See the next sections as an example of how to react on these problems.
 
-Before reaching out for support,
+## Troubleshooting IntelliJ IDEA platform issues
 
-1. Is there already a GitHub issue (open or closed) that covers the problem? Check [Zowe IntelliJ plug-in Issues](https://github.com/zowe/zowe-explorer-intellij/issues).
-2. Try searching using the Zowe Docs search bar.
+Sometimes there could be inconveniences in how your IDE works. Before trying to fix any problem:
+1. Go to **Help** > **About**
 
-When necessary, you can use [the Slack channel](https://openmainframeproject.slack.com/archives/C020BGPSU0M) to reach the Zowe IntelliJ squad for assistance.
+![Open About](../images/troubleshoot/intellij/intellij-troubleshoot-about.png)
+
+2. Click **Copy and Close** button and save this information somewhere for later
+
+![About dialog](../images/troubleshoot/intellij/intellij-troubleshoot-about_dialog.png)
+
+After that, there are a few steps that could be possibly done to fix the issue:
+- **If the issue details are clear and IDE says, which component it is** - copy all the related information and send it to the component's developer
+- **If the issue is unclear** - try to reload IDE / your computer. If the problem persists, try to reinstall the IDE or install the newest one supported LTS version of the IDE you are using
+- **Ask for help or search for the related issue** - there is [an issue tracker](https://youtrack.jetbrains.com/issues/IDEA), related to the IntelliJ IDEA issues. Try to find something related or create a new one
+
+## Troubleshooting the plug-in
+
+If you have an issue with the plug-in:
+1. Click the **gear** button, select **Plugins...**
+
+![Select plugins](../images/troubleshoot/intellij/intellij-go-to-plugins.png)
+
+2. Go to **Installed** tab, locate the plug-in, save **the exact version number**
+
+![Locate the plugin](../images/troubleshoot/intellij/intellij-find-plugin.png)
+
+After these actions, you have some options to try:
+- **If the problem occurs for the plug-in in editor** - try to close the file you are editing, refresh the path and open it again
+- **If the problem occurs with displaying a mask or a filter** - try to hit refresh on a working set or try to recreate a connection and a working set
+- **If the problem occurs for some other issues related to Files Explorer or JES Explorer** - try to recreate a new connection, and a new working set for it
+- **If the problem occurs for TSO Console** - try to reopen the session, try to recreate a session entirely
+- **Other non-related issues, e.g. if the problem occurs for encoding or permissions or "Internal IDE error" notification appears constantly** - copy all the necessary information about the IDE you use and the plug-in's version, [create a new issue](https://github.com/zowe/zowe-explorer-intellij/issues) listing all the necessary information (like the steps to recreate the issue) as well as the versions, or search for the related issue in the repository and put a thumb-up for it, so we know that it should have a higher priority
+
+If you want a direct consulting, don't hesitate to visit our [Slack channel](https://openmainframeproject.slack.com/archives/C020BGPSU0M) and leave a message. Our team is always willing to help with any issues related to the platform or the plug-in, no matter the size of an issue or a question.
diff --git a/docs/troubleshoot/troubleshooting.md b/docs/troubleshoot/troubleshooting.md
@@ -46,7 +46,7 @@ You can also find error messages and codes, must-gathers, and information about
 - [Troubleshooting Zowe CLI](./cli/troubleshoot-cli.md)
 - [Troubleshooting Zowe Explorer](./ze/troubleshoot-ze.md)
 - [Troubleshooting Zowe Chat](./zowe-chat-troubleshoot/troubleshooting.md)
-- [Troubleshooting Zowe IntelliJ plug-in](troubleshoot-intellij.md)
+- [Troubleshooting Zowe Explorer plug-in for IntelliJ IDEA](troubleshoot-intellij.md)
 
 ## Verifying a Zowe release's integrity
 

diff --git a/docs/user-guide/cli-cicsplugin.md b/docs/user-guide/cli-cicsplugin.md
@@ -72,7 +72,7 @@ Alternatively, you can create a CICS profile manually by adding a section that c
 
 2. Browse to the directory `C:\Users\<username>\.zowe`.
 
-3. Open the `zowe.config.json` configuration file using a text editor or IDE, such as Visual Studio Code or IntelliJ.
+3. Open the `zowe.config.json` configuration file using a text editor or IDE, such as Visual Studio Code or IntelliJ IDEA.
 
     :::note
 

diff --git a/docs/user-guide/cli-db2plugin.md b/docs/user-guide/cli-db2plugin.md
@@ -202,7 +202,7 @@ Alternatively, you can create a Db2 profile manually by adding a section that co
 
 2. Browse to the directory `C:\Users\<username>\.zowe`.
 
-3. Open the `zowe.config.json` configuration file using a text editor or IDE, such as Visual Studio Code or IntelliJ.
+3. Open the `zowe.config.json` configuration file using a text editor or IDE, such as Visual Studio Code or IntelliJ IDEA.
 
     :::note
 

diff --git a/docs/user-guide/cli-ftpplugin.md b/docs/user-guide/cli-ftpplugin.md
@@ -78,7 +78,7 @@ Alternatively, you can create an FTP profile manually by adding a section that c
 
 2. Browse to the directory `C:\Users\<username>\.zowe`.
 
-3. Open the `zowe.config.json` configuration file using a text editor or IDE, such as Visual Studio Code or IntelliJ.
+3. Open the `zowe.config.json` configuration file using a text editor or IDE, such as Visual Studio Code or IntelliJ IDEA.
 
     :::note
 

diff --git a/docs/user-guide/cli-install-configure-zosmf.md b/docs/user-guide/cli-install-configure-zosmf.md
@@ -5,7 +5,7 @@ For client-side components to communicate with the mainframe, z/OSMF requires co
 :::info Required role: systems programmer
 :::
 
-Complete the following IBM z/OSMF configuration tasks for the implementation of [Zowe CLI](../user-guide/user-roadmap-zowe-cli.md), [Zowe Explorer for Visual Studio Code](../getting-started/user-roadmap-zowe-explorer.md), or the [Zowe IntelliJ Plug-in](../user-guide/intellij-install.md).
+Complete the following IBM z/OSMF configuration tasks for the implementation of [Zowe CLI](../user-guide/user-roadmap-zowe-cli.md), [Zowe Explorer for Visual Studio Code](../getting-started/user-roadmap-zowe-explorer.md), or the [Zowe Explorer plug-in for IntelliJ IDEA](../user-guide/intellij-configure.md).
 
 :::note
 

diff --git a/docs/user-guide/cli-mqplugin.md b/docs/user-guide/cli-mqplugin.md
@@ -71,7 +71,7 @@ Alternatively, you can create an MQ profile manually by adding a section that co
 
 2. Browse to the directory `C:\Users\<username>\.zowe`.
 
-3. Open the `zowe.config.json` configuration file using a text editor or IDE, such as Visual Studio Code or IntelliJ.
+3. Open the `zowe.config.json` configuration file using a text editor or IDE, such as Visual Studio Code or IntelliJ IDEA.
 
     :::note