diff --git a/topics/_shared/snippets.md b/topics/_shared/snippets.md
index 9f074a87a..b811c554b 100644
--- a/topics/_shared/snippets.md
+++ b/topics/_shared/snippets.md
@@ -91,15 +91,15 @@ _Early Access Program_ (EAP) releases of upcoming versions are available [here](
See [](verifying_plugin_compatibility.md) for overview of API status.
-| Icon | Description | Details |
-|-----------------------------------|-------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| ![Deprecated][deprecated] | Deprecated API | Please see code documentation for replacement |
-| ![Removal][removal] | Scheduled for Removal API | Please see code documentation for replacement |
-| ![Obsolete][obsolete] | Obsolete API | Do not use in new code, please see code documentation for replacement ([](verifying_plugin_compatibility.md#obsolete-api)) |
-| ![Experimental API][experimental] | Experimental API | Annotated with [`@ApiStatus.Experimental`](https://github.com/JetBrains/java-annotations/blob/master/common/src/main/java/org/jetbrains/annotations/ApiStatus.java), API might be altered or removed without prior notice |
-| ![Internal API][internal] | Internal API | Annotated with [`@ApiStatus.Internal`](https://github.com/JetBrains/java-annotations/blob/master/common/src/main/java/org/jetbrains/annotations/ApiStatus.java), must not be used by 3rd party, see [](api_internal.md) |
-| ![Project-Level][project-level] | Project-Level Extension Point/Topic | Can have [`Project`](%gh-ic%/platform/core-api/src/com/intellij/openapi/project/Project.java) as constructor parameter
Extension Point: Declared with `area="IDEA_PROJECT"`
Listener: registered in [``](plugin_configuration_file.md#idea-plugin__projectListeners) |
-| ![Non-Dynamic][non-dynamic] | Non-Dynamic Extension Point | Installation/update of plugin requires IDE restart ([Dynamic Plugins](dynamic_plugins.md)) |
+| Icon | Description | Details |
+|-----------------------------------|-------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| ![Deprecated][deprecated] | Deprecated API | Please see code documentation for replacement |
+| ![Removal][removal] | Scheduled for Removal API | Please see code documentation for replacement |
+| ![Obsolete][obsolete] | Obsolete API | Do not use in new code, please see code documentation for replacement ([](verifying_plugin_compatibility.md#obsolete-api)) |
+| ![Experimental API][experimental] | Experimental API | Annotated with [`@ApiStatus.Experimental`](https://github.com/JetBrains/java-annotations/blob/master/common/src/main/java/org/jetbrains/annotations/ApiStatus.java), API might be altered or removed without prior notice |
+| ![Internal API][internal] | Internal API | Annotated with [`@ApiStatus.Internal`](https://github.com/JetBrains/java-annotations/blob/master/common/src/main/java/org/jetbrains/annotations/ApiStatus.java), must not be used by 3rd party, see [](api_internal.md) |
+| ![Project-Level][project-level] | Project-Level Extension Point/Topic | Can have [`Project`](%gh-ic%/platform/core-api/src/com/intellij/openapi/project/Project.java) as constructor parameter
Extension Point: Declared with `area="IDEA_PROJECT"`
Listener: registered in [``](plugin_configuration_file.md#idea-plugin__projectListeners) |
+| ![Non-Dynamic][non-dynamic] | Non-Dynamic Extension Point | Installation/update of plugin requires IDE restart ([Dynamic Plugins](dynamic_plugins.md)) |
[deprecated]: https://img.shields.io/badge/-Deprecated-lightgrey?style=flat-square
[removal]: https://img.shields.io/badge/-Removal-red?style=flat-square
diff --git a/topics/appendix/resources/learning_resources.md b/topics/appendix/resources/learning_resources.md
index 8a83b8f66..a36fd1374 100644
--- a/topics/appendix/resources/learning_resources.md
+++ b/topics/appendix/resources/learning_resources.md
@@ -29,17 +29,17 @@ A tutorial blog post series for JavaScript developers.
## Webinars
-| Webinar | Info |
-|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| **Busy Plugin Developers #5**
Matthias Koch, 09/2022 |
Building Extensions for Rider and ReSharper |
-| **Busy Plugin Developers #4**
Dmitry Kandalov/Yann Cebron, 04/2022 |
Adding IDE Features at runtime using LivePlugin |
-| **Busy Plugin Developers #3**
Jakub Chrzanowski/Anna Maltceva/Yann Cebron, 11/2021 |
Building Themes for IntelliJ-based IDEs
Latest updates to JetBrains Marketplace |
-| **Busy Plugin Developers #2**
Anna Maltceva/Łukasz Wawrzyk/Jakub Chrzanowski, 09/2021 |
How to improve your Marketplace plugin page to attract more users
ide-probe, a testing and benchmarking framework for IntelliJ-based IDEs |
-| **Busy Plugin Developers #1**
Jakub Chrzanowski/Semyon Atamas/Paweł Lipski, 07/2021 |
What is Gradle IntelliJ Plugin
New features of Gradle IntelliJ Plugin
How to start with Gradle IntelliJ Plugin
Types of signing and how they work
How JetBrains Marketplace signature works
How to sign your plugin
Tools and tips for testing UI of IntelliJ Plugins |
-| **Make IntelliJ IDEA Your Own**
Sirisha Pratha, 05/2021 |
In this session, we'll explore the benefits provided by IntelliJ IDEA's customization options, and you will learn how to make the IDE your own. We will also look at the plugins available on the JetBrains Marketplace, discuss the process of developing them, and demo a few custom ones. |
-| **IntelliJ IDEA Conf 2021**
Various Speakers, 02/2021 |
Playlist includes a number of presentations related to plugin development |
-| **Busy Plugin Developers #0**
Mikhail Vink/Jakub Chrzanowski/Yann Cebron, 12/2020 |
IntelliJ Platform Plugin Template
Plugin DevKit Features
IntelliJ Platform Explorer
What's coming in 2021?
Introduction to the Marketplace
How to make your plugin successful?
Sell on the Marketplace |
-| **How We Built Comma, the Raku IDE, on the IntelliJ Platform**
Jonathan Worthington, 01/2020 |
How to build custom language support
How to go from a language support plugin to an IDE
Lessons Learned
[Blog post](https://blog.jetbrains.com/platform/2020/01/webinar-recording-how-we-built-comma-the-raku-ide-on-the-intellij-platform/) |
-| **Building IntelliJ IDEA plugins in Scala**
Igal Tabachnik, 2020 |
In this talk, I will show how to create plugins for IDEA from scratch in Scala, and show why Scala's unique features make it a great fit for such tasks as inspecting and manipulating Abstract Syntax Trees (ASTs) to create your own custom suggestions and quick-fixes. |
-| **Live Development of a PyCharm Plugin**
Joachim Ansorg, 2019 |
Background and architecture of IntelliJ plugins
Development using tests
Implementing interesting extension points
Viewing the plugin in the IDE (PyCharm)
[Blog post](https://blog.jetbrains.com/pycharm/2019/01/webinar-recording-live-development-of-a-pycharm-plugin-with-joachim-ansorg/) |
-| **Build Developer Tools On Top of IntelliJ Platform**
Dmitry Jemerov, 2013 |
This webinar makes an overview on IntelliJ Platform and explains how you can use it for building your own products. |
+| Webinar | Info |
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Busy Plugin Developers #5**
Matthias Koch, 09/2022 | Building Extensions for Rider and ReSharper |
+| **Busy Plugin Developers #4**
Dmitry Kandalov/Yann Cebron, 04/2022 | Adding IDE Features at runtime using LivePlugin |
+| **Busy Plugin Developers #3**
Jakub Chrzanowski/Anna Maltceva/Yann Cebron, 11/2021 | Building Themes for IntelliJ-based IDEs
Latest updates to JetBrains Marketplace |
+| **Busy Plugin Developers #2**
Anna Maltceva/Łukasz Wawrzyk/Jakub Chrzanowski, 09/2021 | How to improve your Marketplace plugin page to attract more users
ide-probe, a testing and benchmarking framework for IntelliJ-based IDEs |
+| **Busy Plugin Developers #1**
Jakub Chrzanowski/Semyon Atamas/Paweł Lipski, 07/2021 | What is Gradle IntelliJ Plugin
New features of Gradle IntelliJ Plugin
How to start with Gradle IntelliJ Plugin
Types of signing and how they work
How JetBrains Marketplace signature works
How to sign your plugin
Tools and tips for testing UI of IntelliJ Plugins |
+| **Make IntelliJ IDEA Your Own**
Sirisha Pratha, 05/2021 | In this session, we'll explore the benefits provided by IntelliJ IDEA's customization options, and you will learn how to make the IDE your own. We will also look at the plugins available on the JetBrains Marketplace, discuss the process of developing them, and demo a few custom ones. |
+| **IntelliJ IDEA Conf 2021**
Various Speakers, 02/2021 | Playlist includes a number of presentations related to plugin development |
+| **Busy Plugin Developers #0**
Mikhail Vink/Jakub Chrzanowski/Yann Cebron, 12/2020 | IntelliJ Platform Plugin Template
Plugin DevKit Features
IntelliJ Platform Explorer
What's coming in 2021?
Introduction to the Marketplace
How to make your plugin successful?
Sell on the Marketplace |
+| **How We Built Comma, the Raku IDE, on the IntelliJ Platform**
Jonathan Worthington, 01/2020 | How to build custom language support
How to go from a language support plugin to an IDE
Lessons Learned
[Blog post](https://blog.jetbrains.com/platform/2020/01/webinar-recording-how-we-built-comma-the-raku-ide-on-the-intellij-platform/) |
+| **Building IntelliJ IDEA plugins in Scala**
Igal Tabachnik, 2020 | In this talk, I will show how to create plugins for IDEA from scratch in Scala, and show why Scala's unique features make it a great fit for such tasks as inspecting and manipulating Abstract Syntax Trees (ASTs) to create your own custom suggestions and quick-fixes. |
+| **Live Development of a PyCharm Plugin**
Joachim Ansorg, 2019 | Background and architecture of IntelliJ plugins
Development using tests
Implementing interesting extension points
Viewing the plugin in the IDE (PyCharm)
[Blog post](https://blog.jetbrains.com/pycharm/2019/01/webinar-recording-live-development-of-a-pycharm-plugin-with-joachim-ansorg/) |
+| **Build Developer Tools On Top of IntelliJ Platform**
Dmitry Jemerov, 2013 | This webinar makes an overview on IntelliJ Platform and explains how you can use it for building your own products. |
diff --git a/topics/basics/getting_started/theme/creating_theme_project.md b/topics/basics/getting_started/theme/creating_theme_project.md
index 04741f381..9eb60bc72 100644
--- a/topics/basics/getting_started/theme/creating_theme_project.md
+++ b/topics/basics/getting_started/theme/creating_theme_project.md
@@ -57,7 +57,8 @@ The wizard can be used for both DevKit-based and Gradle-based plugins.
1. In the Project tool window, select the resources directory and invoke the context menu with the right click.
-2. Select the New | Plugin DevKit | Theme action.
+2. Select the New | Plugin DevKit | Theme action.
+
It is a good practice to include the name of the plugin in the created theme name.
3. Check the Dark theme checkbox if the created theme should be based on IntelliJ IDEA _Darcula_ theme.
Otherwise, the _Light_ theme will be used as the base.
diff --git a/topics/basics/getting_started/theme/deploying_theme.md b/topics/basics/getting_started/theme/deploying_theme.md
index 4b3d845ff..268f9b187 100644
--- a/topics/basics/getting_started/theme/deploying_theme.md
+++ b/topics/basics/getting_started/theme/deploying_theme.md
@@ -1,7 +1,7 @@
-# Deploying a Theme
-
+# Deploying a Theme
+
Building and deploying a theme in IDE.
Before your custom theme plugin can be [uploaded to JetBrains Marketplace](publishing_plugin.md#uploading-a-plugin-to-jetbrains-marketplace) and used by users, it should be packaged and verified in the actual IDE.
@@ -11,8 +11,10 @@ The deployment process prepares the plugin artifact that can be installed in IDE
1. Build the theme by invoking Build | Build Project or Build | Build Module $MODULE_NAME$.
-2. Create the deployment artifact by invoking Build | Prepare Plugin Module $MODULE_NAME$ for Deployment.
- The resulting theme JAR file will be created in the project or module directory.
+2. Create the deployment artifact by invoking Build | Prepare Plugin Module $MODULE_NAME$ for Deployment.
+
+ The resulting theme JAR file will be created in the project or module directory.
+
In the case of developing a regular plugin, and it specifies additional dependencies, a ZIP archive is created, including all the plugin libraries.
3. [Install](https://www.jetbrains.com/help/idea/managing-plugins.html#installing-plugins-from-disk) the newly created JAR or ZIP file from disk.
4. Click the Apply button.
diff --git a/topics/basics/getting_started/theme/setting_up_theme_environment.md b/topics/basics/getting_started/theme/setting_up_theme_environment.md
index 3c289fe89..628f642b7 100644
--- a/topics/basics/getting_started/theme/setting_up_theme_environment.md
+++ b/topics/basics/getting_started/theme/setting_up_theme_environment.md
@@ -10,9 +10,10 @@ Use the following checklist to ensure that you are ready to develop your custom
1. **[IntelliJ IDEA Community Edition](https://www.jetbrains.com/idea/download/)** or **[IntelliJ IDEA Ultimate](https://www.jetbrains.com/idea/download/)** is installed.
2. **Plugin DevKit** plugin is [enabled in IntelliJ IDEA](https://www.jetbrains.com/help/idea/managing-plugins.html).
-3. **IntelliJ IDEA CE source code** is checked-out. _(Optional)_
- This step is needed only when you plan to debug the IntelliJ Platform code.
- See [](#get-intellij-idea-ce-source-code) for more details.
+3. **IntelliJ IDEA CE source code** is checked-out. _(Optional)_
+
+ This step is needed only when you plan to debug the IntelliJ Platform code.
+ See [](#get-intellij-idea-ce-source-code) for more details.
4. **IntelliJ Platform SDK** is [configured](#configuring-intellij-platform-plugin-sdk).
@@ -46,8 +47,9 @@ The first step of configuring a theme plugin SDK is adding the JDK.
1. Go to File | Project Structure | Platform Settings | SDKs.
2. Click the Add button (+).
3. If you have the required JDK installation on your machine, and it is detected, select it from the Detected SDKs list.
- If your JDK is not detected, select the Add JDK... option and choose the installation folder.
- If the required JDK is not installed on your machine, the simplest option is using Download JDK... and choosing the distribution options.
+ If your JDK is not detected, select the Add JDK... option and choose the installation folder.
+
+ If the required JDK is not installed on your machine, the simplest option is using Download JDK... and choosing the distribution options.
4. Click the Apply button.
@@ -61,7 +63,8 @@ The second step is adding IntelliJ Platform Plugin SDK that will use the JDK con
3. Select the Add IntelliJ Platform Plugin SDK... option.
4. Choose the installation folder of the IDE [downloaded previously](#download-intellij-based-ide) (on macOS, select application icon in /Applications/).
5. In the Select Internal Java Platform dialog, select the JDK configured in the [previous step](#add-jdk) and click OK button.
-6. In the added SDK, specify the Sandbox Home directory.
+6. In the added SDK, specify the Sandbox Home directory.
+
See [](ide_development_instance.md#the-development-instance-sandbox-directory) for details.
7. If debugging is required, select the Sourcepath tab, click the Add button (+) and select the root folder of [the checked-out sources](#get-intellij-idea-ce-source-code).
8. Click the Apply button.
diff --git a/topics/reference_guide/intellij_artifacts.md b/topics/reference_guide/intellij_artifacts.md
index 173da3742..073f75378 100644
--- a/topics/reference_guide/intellij_artifacts.md
+++ b/topics/reference_guide/intellij_artifacts.md
@@ -45,9 +45,15 @@ To set up dependencies on a module, there are two types of information needed:
### Specify the Repository URL
The URL for the desired artifact needs to be added to a Maven or Gradle script:
-* For release versions, use:
`https://www.jetbrains.com/intellij-repository/releases`
-* For EAP snapshots, use:
`https://www.jetbrains.com/intellij-repository/snapshots`
-* For dependencies on individual modules from the IntelliJ Platform, also use:
`https://cache-redirector.jetbrains.com/intellij-dependencies`
+* For release versions, use:
+
+ `https://www.jetbrains.com/intellij-repository/releases`
+* For EAP snapshots, use:
+
+ `https://www.jetbrains.com/intellij-repository/snapshots`
+* For dependencies on individual modules from the IntelliJ Platform, also use:
+
+ `https://cache-redirector.jetbrains.com/intellij-dependencies`
### Specify the Maven Coordinates for the Artifact
diff --git a/topics/user_interface_components/popups.md b/topics/user_interface_components/popups.md
index a03be6080..698f10681 100644
--- a/topics/user_interface_components/popups.md
+++ b/topics/user_interface_components/popups.md
@@ -12,12 +12,12 @@ Popups can optionally display a title, are optionally movable and resizable (and
The [`JBPopupFactory`](%gh-ic%/platform/platform-api/src/com/intellij/openapi/ui/popup/JBPopupFactory.java) interface allows you to create popups that display different kinds of components, depending on your specific needs.
The most commonly used methods are:
-| Method | Description |
-|---------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `createComponentPopupBuilder()` | Generic, allows showing any [Swing](https://docs.oracle.com/javase/tutorial/uiswing/start/index.html) component.
**Example**: [`IntentionPreviewPopupUpdateProcessor`](%gh-ic%/platform/lang-impl/src/com/intellij/codeInsight/intention/impl/preview/IntentionPreviewPopupUpdateProcessor.kt) creating a popup rendering the intention preview. |
-| `createPopupChooserBuilder()` | For choosing one or more items from a plain `java.util.List`.
**Example**: [`ShowMessageHistoryAction`](%gh-ic%/platform/vcs-impl/src/com/intellij/openapi/vcs/actions/ShowMessageHistoryAction.kt) creating a popup with recent commit messages history in the commit message text area. |
-| `createConfirmation()` | For choosing between two options, and performing different actions depending on which option is selected.
**Example**: [`VariableInplaceRenamer`](%gh-ic%/platform/lang-impl/src/com/intellij/refactoring/rename/inplace/VariableInplaceRenamer.java) creating confirmation popup after invalid variable name is provided in the inplace rename action. |
-| `createActionGroupPopup()` | Show actions from an [Action Group](grouping_action.md) and executes the action selected by the user.
**Example**: [`ShowRecentFindUsagesGroup`](%gh-ic%/platform/lang-impl/src/com/intellij/find/impl/ShowRecentFindUsagesGroup.java) invoked via Edit / Find Usages / Recent Find Usages and showing recent find usages group popup. |
+| Method | Description |
+|---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `createComponentPopupBuilder()` | Generic, allows showing any [Swing](https://docs.oracle.com/javase/tutorial/uiswing/start/index.html) component.
**Example**: [`IntentionPreviewPopupUpdateProcessor`](%gh-ic%/platform/lang-impl/src/com/intellij/codeInsight/intention/impl/preview/IntentionPreviewPopupUpdateProcessor.kt) creating a popup rendering the intention preview. |
+| `createPopupChooserBuilder()` | For choosing one or more items from a plain `java.util.List`.
**Example**: [`ShowMessageHistoryAction`](%gh-ic%/platform/vcs-impl/src/com/intellij/openapi/vcs/actions/ShowMessageHistoryAction.kt) creating a popup with recent commit messages history in the commit message text area. |
+| `createConfirmation()` | For choosing between two options, and performing different actions depending on which option is selected.
**Example**: [`VariableInplaceRenamer`](%gh-ic%/platform/lang-impl/src/com/intellij/refactoring/rename/inplace/VariableInplaceRenamer.java) creating confirmation popup after invalid variable name is provided in the inplace rename action. |
+| `createActionGroupPopup()` | Show actions from an [Action Group](grouping_action.md) and executes the action selected by the user.
**Example**: [`ShowRecentFindUsagesGroup`](%gh-ic%/platform/lang-impl/src/com/intellij/find/impl/ShowRecentFindUsagesGroup.java) invoked via Edit / Find Usages / Recent Find Usages and showing recent find usages group popup. |
### Action Groups