add labels to content

labels.list

@@ -9,7 +9,14 @@
   <primary-label id="IntelliJIDEA_Ultimate" short-name="IntelliJ IDEA Ultimate" name="IntelliJ IDEA Ultimate"
                  href="https://plugins.jetbrains.com/docs/intellij/idea-ultimate.html"/>
 
+  <primary-label id="2020.3" short-name="2020.3+" name="2020.3+"/>
   <primary-label id="2021.3" short-name="2021.3+" name="2021.3+"/>
+  <primary-label id="2022.1" short-name="2022.1+" name="2022.1+"/>
+  <primary-label id="2022.2" short-name="2022.2+" name="2022.2+"/>
+  <primary-label id="2022.3" short-name="2022.3+" name="2022.3+"/>
+  <primary-label id="2023.1" short-name="2023.1+" name="2023.1+"/>
+  <primary-label id="2023.2" short-name="2023.2+" name="2023.2+"/>
+  <primary-label id="2023.3" short-name="2023.3+" name="2023.3+"/>
   <primary-label id="2024.1" short-name="2024.1+" name="2024.1+"/>
   <primary-label id="2024.2" short-name="2024.2+" name="2024.2+"/>
 </labels>

topics/basics/basic_action_system.md

@@ -41,28 +41,42 @@ The IntelliJ Platform calls methods of actions when a user interacts with a menu
 ### Principal Implementation Overrides
 
 Every IntelliJ Platform action should override `AnAction.update()` and must override `AnAction.actionPerformed()`.
-* An action's method `AnAction.update()` is called by the IntelliJ Platform framework to update an action state.
-  The state (enabled, visible) of an action determines whether the action is available in the UI.
-  An object of the [`AnActionEvent`](%gh-ic%/platform/editor-ui-api/src/com/intellij/openapi/actionSystem/AnActionEvent.java) type is passed to this method and contains information about the current context for the action.
-  Actions are made available by changing state in the [`Presentation`](%gh-ic%/platform/editor-ui-api/src/com/intellij/openapi/actionSystem/Presentation.java) object associated with the event context.
-  As explained in [Overriding the `AnAction.update()`  Method](#overriding-the-anactionupdate-method), it is vital `update()` methods _execute quickly_ and return execution to platform.
-* `AnAction.getActionUpdateThread()` (2022.3+) return an [`ActionUpdateThread`](%gh-ic%/platform/editor-ui-api/src/com/intellij/openapi/actionSystem/ActionUpdateThread.java),
-  which specifies if the `update()` method is called on a [background thread (BGT) or the event-dispatching thread (EDT)](general_threading_rules.md).
-  The preferred method is to run the update on the BGT, which has the advantage of guaranteeing application-wide read access to
-  [PSI](psi.md), [the virtual file system](virtual_file_system.md) (VFS), or [project models](project_structure.md).
-  Actions that run the update session on the BGT should not access the Swing component hierarchy directly.
-  Conversely, actions that specify to run their update on EDT must not access PSI, VFS, or project data but have access to Swing components and other UI models.
-  All accessible data is provided by the `DataContext` as explained in [](#determining-the-action-context).
-  When switching from BGT to EDT is absolutely necessary, actions can use `AnActionEvent.getUpdateSession()` to
-  access the [`UpdateSession`](%gh-ic%/platform/editor-ui-api/src/com/intellij/openapi/actionSystem/UpdateSession.java) and
-  then call `UpdateSession.compute()` to run a function on EDT.
-  Inspection <ui-path>Plugin DevKit | Code | ActionUpdateThread is missing</ui-path> highlights missing implementation of
-  `AnAction.getActionUpdateThread()` (2022.3+).
-* An action's method `AnAction.actionPerformed()` is called by the IntelliJ Platform if available and selected by the user.
-  This method does the heavy lifting for the action: it contains the code executed when the action gets invoked.
-  The `actionPerformed()` method also receives `AnActionEvent` as a parameter, which is used to access any context data like projects, files, selection, etc.
-  See [Overriding the `AnAction.actionPerformed()` Method](#overriding-the-anactionactionperformed-method) for more information.
 
+#### `AnAction.update()`
+
+An action's method `AnAction.update()` is called by the IntelliJ Platform framework to update an action state.
+The state (enabled, visible) of an action determines whether the action is available in the UI.
+An object of the [`AnActionEvent`](%gh-ic%/platform/editor-ui-api/src/com/intellij/openapi/actionSystem/AnActionEvent.java) type is passed to this method and contains information about the current context for the action.
+
+Actions are made available by changing state in the [`Presentation`](%gh-ic%/platform/editor-ui-api/src/com/intellij/openapi/actionSystem/Presentation.java) object associated with the event context.
+As explained in [Overriding the `AnAction.update()`  Method](#overriding-the-anactionupdate-method), it is vital `update()` methods _execute quickly_ and return execution to platform.
+
+#### `AnAction.getActionUpdateThread()`
+<primary-label ref="2022.3"/>
+
+`AnAction.getActionUpdateThread()` returns an [`ActionUpdateThread`](%gh-ic%/platform/editor-ui-api/src/com/intellij/openapi/actionSystem/ActionUpdateThread.java),
+which specifies if the `update()` method is called on a [background thread (BGT) or the event-dispatching thread (EDT)](general_threading_rules.md).
+The preferred method is to run the update on the BGT, which has the advantage of guaranteeing application-wide read access to
+[PSI](psi.md), [the virtual file system](virtual_file_system.md) (VFS), or [project models](project_structure.md).
+Actions that run the update session on the BGT should not access the Swing component hierarchy directly.
+Conversely, actions that specify to run their update on EDT must not access PSI, VFS, or project data but have access to Swing components and other UI models.
+
+All accessible data is provided by the `DataContext` as explained in [](#determining-the-action-context).
+When switching from BGT to EDT is absolutely necessary, actions can use `AnActionEvent.getUpdateSession()` to
+access the [`UpdateSession`](%gh-ic%/platform/editor-ui-api/src/com/intellij/openapi/actionSystem/UpdateSession.java) and
+then call `UpdateSession.compute()` to run a function on EDT.
+
+Inspection <ui-path>Plugin DevKit | Code | ActionUpdateThread is missing</ui-path> highlights missing implementation of
+`AnAction.getActionUpdateThread()`.
+
+#### `AnAction.actionPerformed()`
+
+An action's method `AnAction.actionPerformed()` is called by the IntelliJ Platform if available and selected by the user.
+This method does the heavy lifting for the action: it contains the code executed when the action gets invoked.
+The `actionPerformed()` method also receives `AnActionEvent` as a parameter, which is used to access any context data like projects, files, selection, etc.
+See [Overriding the `AnAction.actionPerformed()` Method](#overriding-the-anactionactionperformed-method) for more information.
+
+#### Miscellaneous
 There are other methods to override in the `AnAction` class, such as changing the default `Presentation` object for the action.
 There is also a use case for overriding action constructors when registering them with dynamic action groups, demonstrated in the [Grouping Actions](grouping_action.md#adding-child-actions-to-the-dynamic-group) tutorial.
 
@@ -216,8 +230,8 @@ To allow using alternative names in search, add one or more [`<synonym>`](plugin
 To provide a localized synonym, specify `key` instead of `text` attribute.
 
 #### Disabling Search for Group
+<primary-label ref="2020.3"/>
 
-_2020.3_
 To exclude a group from appearing in <ui-path>Help | Find Action</ui-path> results (e.g., <control>New...</control> popup), specify `searchable="false"`.
 
 #### Localizing Actions and Groups

topics/basics/persisting_state_of_components.md

@@ -212,10 +212,7 @@ Only the settings that are not specific to a given machine should be shared, e.g
 If a component contains both shareable and non-shareable data, it should be split into two separate components.
 
 #### Settings Sync Plugin
-
+<primary-label ref="2022.3"/>
-> The _Settings Sync_ plugin is available starting with version 2022.3.
->
-{style="note"}
 
 To include a plugin's component state in the _Settings Sync_ plugin synchronization, the following requirements must be met:
 - The `RoamingType` is defined via the `roamingType` attribute of the `@Storage` annotation and is not equal to `DISABLED`.

topics/basics/psi_cookbook.md

@@ -70,8 +70,7 @@ or
 [`OverridingMethodsSearch.search()`](%gh-ic%/java/java-indexing-api/src/com/intellij/psi/search/searches/OverridingMethodsSearch.java)
 
 ### How do I check the presence of a JVM library?
-
+<primary-label ref="2023.2"/>
-_2023.2_
 
 Use dedicated (and heavily cached) methods from [`JavaLibraryUtil`](%gh-ic%/java/openapi/src/com/intellij/java/library/JavaLibraryUtil.java):
 

topics/reference_guide/custom_language_support/code_inspections_and_intentions.md

@@ -34,9 +34,10 @@ See [Inspections](inspections.md) topic in the UI Guidelines on naming, writing
 > Please also note important change in 2024.1, refer to [](syntax_highlighting_and_error_highlighting.md#order-of-running-highlighting).
 
 #### Inspections Performance
+<primary-label ref="2023.3"/>
 
 A [custom language plugin](custom_language_support.md) providing many inspections (>100) can register the default [`PsiElementVisitor`](%gh-ic%/platform/core-api/src/com/intellij/psi/PsiElementVisitor.java)
-for its language in `com.intellij.inspection.basicVisitor` extension point (2023.3) to optimize processing.
+for its language in `com.intellij.inspection.basicVisitor` extension point to optimize processing.
 
 ### Intentions
 

topics/reference_guide/custom_language_support/documentation.md

@@ -31,6 +31,7 @@ Detailed information on implementing these EPs can be found in the [](#documenta
 {title="Targeting IDEs before 2023.1" style="note"}
 
 ## Documentation Target API
+<primary-label ref="2023.1"/>
 
 Custom language developers have the flexibility to select from three distinct EPs for providing documentation to their users.
 To ensure clarity and avoid confusion, we provide a high-level summary of the overall approach,

topics/reference_guide/custom_language_support/inlay_hints.md

@@ -53,10 +53,7 @@ To suppress inlay parameter hints in specific places, implement
 and register it in `com.intellij.codeInsight.parameterNameHintsSuppressor` EP.
 
 ### Declarative Inlay Hints Provider
-
+<primary-label ref="2023.1"/>
-> This API is available since 2023.1.
->
-{style="note"}
 
 Declarative inlay hints are **inline** textual inlays that can hold expandable list of clickable items.
 Please note this API has limited presentation customization possibilities due to its UI-independent design, which allows utilizing it by different frontend technologies (not only in Swing).
@@ -71,9 +68,9 @@ See the API documentation for the details.
 - [`JavaMethodChainsDeclarativeInlayProvider`](%gh-ic%/java/java-impl/src/com/intellij/codeInsight/hints/JavaMethodChainsDeclarativeInlayProvider.kt) - shows method return types in call chains in Java code
 
 ### Code Vision Provider
+<primary-label ref="2022.1"/>
 
-> This API is available since 2022.1.
+> This API is still in experimental state and may be changed without preserving backward compatibility.
-> It is still in experimental state and may be changed without preserving backward compatibility.
 >
 {style="note"}
 

topics/reference_guide/custom_language_support/language_injection.md

@@ -307,8 +307,9 @@ final class MyDSLInjector implements MultiHostInjector {
 Now, inside the editor the injected portion will work as expected where foo is the method name and `System.out.println(42);` will look and feel like a method body with highlighting, completion, and goto definition working.
 
 ## Formatting
+<primary-label ref="2022.3"/>
 
-To control delegation of formatting to containing file, implement [`InjectedFormattingOptionsProvider`](%gh-ic%/platform/code-style-api/src/com/intellij/formatting/InjectedFormattingOptionsProvider.java) and register in `com.intellij.formatting.injectedOptions` extension point (_2022.3_).
+To control delegation of formatting to containing file, implement [`InjectedFormattingOptionsProvider`](%gh-ic%/platform/code-style-api/src/com/intellij/formatting/InjectedFormattingOptionsProvider.java) and register in `com.intellij.formatting.injectedOptions` extension point.
 
 ## Injection Highlighting
 

topics/reference_guide/custom_language_support/language_server_protocol.md

@@ -116,8 +116,9 @@ private class FooLspServerDescriptor(project: Project) : ProjectWideLspServerDes
 </procedure>
 
 ### Status Bar Integration
+<primary-label ref="2024.1"/>
 
-Since 2024.1, a dedicated <control>Language Services</control> status bar widget is available to monitor the status of all LSP servers.
+A dedicated <control>Language Services</control> status bar widget is available to monitor the status of all LSP servers.
 Override `LspServerSupportProvider.createLspServerWidgetItem()` to provide a custom icon and link to [Settings](settings.md) page (if available).
 
 ```kotlin

topics/reference_guide/custom_language_support/references_and_resolve.md

@@ -69,6 +69,7 @@ The <ui-path>Navigate | Declaration or Usages</ui-path> action for such referenc
 The implementation of `multiResolve()` can be also based on [`PsiScopeProcessor`](%gh-ic%/platform/core-api/src/com/intellij/psi/scope/PsiScopeProcessor.java), and can collect all valid targets for the reference instead of stopping when the first valid target is found.
 
 ## Additional Highlighting
+<primary-label ref="2022.2"/>
 
 Implement [`HighlightedReference`](%gh-ic%/platform/lang-impl/src/com/intellij/codeInsight/highlighting/HighlightedReference.java) to add additional highlighting for non-obvious places (e.g., inside String literals).
-Such references will automatically be highlighted using <control>String | Highlighted reference</control> text attributes from <ui-path>Settings | Editor | Color Scheme | Language Defaults</ui-path> (_2022.2_).
+Such references will automatically be highlighted using <control>String | Highlighted reference</control> text attributes from <ui-path>Settings | Editor | Color Scheme | Language Defaults</ui-path>.

topics/reference_guide/custom_language_support/syntax_highlighting_and_error_highlighting.md

@@ -168,8 +168,9 @@ To force re-highlighting all open or specific file(s) (e.g., after changing plug
 [`DaemonCodeAnalyzer.restart()`](%gh-ic%/platform/analysis-api/src/com/intellij/codeInsight/daemon/DaemonCodeAnalyzer.java).
 
 ## Order of Running Highlighting
+<primary-label ref="2024.1"/>
 
-Since 2024.1, [inspections](code_inspections_and_intentions.md) and [annotators](#annotator) do not run sequentially on each `PsiElement` anymore.
+[Inspections](code_inspections_and_intentions.md) and [annotators](#annotator) do not run sequentially on each `PsiElement` anymore.
 Instead, they're run in parallel on all relevant PSI independently with the following consequences.
 
 **Independent Annotators**

topics/reference_guide/custom_language_support/websymbols.md

@@ -1,6 +1,7 @@
 <!-- Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
 
 # Web Symbols
+<primary-label ref="2022.3"/>
 
 <link-summary>
 Web Symbols framework simplifies web technology development by utilizing Symbol API and supporting custom syntaxes.

topics/reference_guide/custom_language_support/websymbols_context.md

@@ -1,6 +1,7 @@
 <!-- Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
 
 # Web Symbols Context
+<primary-label ref="2022.3"/>
 
 <link-summary>How to use Web Symbols context detection to manage enablement of plugin features.</link-summary>
 

topics/reference_guide/custom_language_support/websymbols_implementation.md

@@ -1,6 +1,7 @@
 <!-- Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
 
 # Implementing Web Symbols
+<primary-label ref="2022.3"/>
 
 <link-summary>Implementation details for the Web Symbols API.</link-summary>
 

topics/reference_guide/custom_language_support/websymbols_integration.md

@@ -1,6 +1,7 @@
 <!-- Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
 
 # Web Symbols Integration with Language Features
+<primary-label ref="2022.3"/>
 
 <link-summary>How to integrate your Web Symbols with a particular language feature.</link-summary>
 

topics/reference_guide/custom_language_support/websymbols_web_types.md

@@ -1,6 +1,7 @@
 <!-- Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
 
 # Web Types
+<primary-label ref="2022.3"/>
 
 <link-summary>Web Types - contributing statically defined Web Symbols through JSONs.</link-summary>
 

topics/reference_guide/icons.md

@@ -217,9 +217,8 @@ Register a resource bundle via `com.intellij.iconDescriptionBundle` extension po
 Create `icon.<icon-path>.tooltip` key in a resource bundle, where `<icon-path>` is the icon path with leading slash and `.svg` removed and slashes replaced with dots (e.g., `/nodes/class.svg` &rarr; `icon.nodes.class.tooltip`).
 
 ## New UI Icons
+<primary-label ref="2022.3"/>
 
-> This feature is available since 2022.3.
->
 > See [New UI Icons Guide](https://www.figma.com/community/file/1227729570033544559) for guidelines and overview.
 
 To fully support the [New UI](https://www.jetbrains.com/help/idea/new-ui.html), the plugin must provide additional dedicated icons and mapping information.

topics/reference_guide/inspection_options.md

@@ -12,10 +12,7 @@ Currently, there are two ways of providing the inspection options:
 * [UI-based](#ui-based-inspection-options)
 
 ## Declarative Inspection Options
-
+<primary-label ref="2023.1"/>
-> Declarative inspection options API is available since version 2023.1.
->
-{style="note"}
 
 Declarative API allows to:
 * delegate component rendering to the platform and make all the inspection options UI consistent and compliant with the [](ui_guidelines_welcome.topic)

topics/tutorials/code_intentions_preview.md

@@ -3,13 +3,14 @@
 <!-- Copyright 2000-2023 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
 
 <link-summary>Guide for the preview of Intention and Quick Fix actions.</link-summary>
+<primary-label ref="2022.3"/>
 
 > [Intention](code_intentions.md) previews are supposed to work out-of-the-box in most cases.
 > This page gives guidance to plugin authors in situations where this is not the case and to
 > encourage thorough [testing](writing_tests.md) of intention actions.
 
 
-Since version 2022.3, the IntelliJ Platform can show a preview for
+The IntelliJ Platform can show a preview for
 [`IntentionAction`](%gh-ic%/platform/analysis-api/src/com/intellij/codeInsight/intention/IntentionAction.java)
 and
 [`LocalQuickFix`](%gh-ic%/platform/analysis-api/src/com/intellij/codeInspection/LocalQuickFix.java).

topics/user_interface_components/kotlin_ui_dsl_version_2.md

@@ -1,6 +1,7 @@
 <!-- Copyright 2000-2024 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license. -->
 
 # Kotlin UI DSL Version 2
+<primary-label ref="2021.3"/>
 
 <link-summary>Kotlin DSL for creating UI forms with input components bound to a state object.</link-summary>