diff --git a/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin.md b/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin.md
index 374d06d57..3d84fa629 100644
--- a/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin.md
+++ b/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin.md
@@ -1,4 +1,4 @@
-
+
# IntelliJ Platform Gradle Plugin (2.x)
@@ -40,7 +40,7 @@ IntelliJ Platform Gradle Plugin 2.x requires the following *minimal* versions:
See Gradle JVM in Settings | Build, Execution, Deployment | Build Tools | Gradle.
-## Usage
+## Setup
> Note that the plugin has a new ID `org.jetbrains.intellij.platform`.
>
@@ -72,7 +72,7 @@ plugins {
If migrating from the [](tools_gradle_intellij_plugin.md), replace the old `org.jetbrains.intellij` identifier to `org.jetbrains.intellij.platform` and apply its latest `%intellij-platform-gradle-plugin-version%` version.
-### Snapshot Release
+### Using Snapshot Release
To use the latest snapshot version of this plugin, add the following to the Gradle Settings file:
@@ -123,7 +123,7 @@ When working in a [](#multi-module-project-structure) it is required to use [](t
The [](tools_intellij_platform_gradle_plugin_plugins.md#settings) plugin (`org.jetbrains.intellij.platform.settings`) allows for adding plugin development related repositories right in the settings.gradle.kts file if project configuration involves [](#configuration.dependencyResolutionManagement).
-### Attaching Sources
+### Attaching Sources in the IDE
To attach IntelliJ Platform sources in the IDE, the Download sources setting has to be enabled in IDE versions 2023.2 and later.
This option respects the plugin's [](tools_intellij_platform_gradle_plugin_gradle_properties.md#downloadSources) property, which is enabled by default.
diff --git a/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_extension.md b/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_extension.md
index 63a3dfcbe..db2182a4c 100644
--- a/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_extension.md
+++ b/topics/appendix/tools/intellij_platform_gradle_plugin/tools_intellij_platform_gradle_plugin_extension.md
@@ -1,4 +1,4 @@
-
+
# IntelliJ Platform Extension
@@ -13,7 +13,7 @@ It consists of sections dedicated to the general Gradle plugin configuration,
+
# IntelliJ Platform Testing Extension
@@ -15,7 +15,7 @@ For each of the custom tasks, a dedicated sandbox is created to isolate them for
{#intellijPlatformTesting}
-After the IntelliJ Platform Gradle Plugin is [applied](tools_intellij_platform_gradle_plugin.md#usage), the `intellijPlatformTesting` extension can be used for registering new tasks to fulfil specific requirements of the project.
+After the IntelliJ Platform Gradle Plugin is [applied](tools_intellij_platform_gradle_plugin.md#setup), the `intellijPlatformTesting` extension can be used for registering new tasks to fulfil specific requirements of the project.
The extension exposes four `NamedDomainObjectContainers` which allow for creating new objects of given types.
Registering of a custom task which allows for adjusting the IntelliJ Platform type and version can be done by using one of the below containers, depending on the task purpose.
diff --git a/topics/reference_guide/custom_language_support/language_server_protocol.md b/topics/reference_guide/custom_language_support/language_server_protocol.md
index d9c6275ec..f336a2613 100644
--- a/topics/reference_guide/custom_language_support/language_server_protocol.md
+++ b/topics/reference_guide/custom_language_support/language_server_protocol.md
@@ -103,7 +103,7 @@ The plugin.xml configuration file must specify the dependency on th
### IDE Setup
Since 2024.2, LSP API sources are provided with the `IntelliJ IDEA Ultimate sources` artifact.
-See [](tools_intellij_platform_gradle_plugin.md#attaching-sources) on how to enable downloading sources.
+See [](tools_intellij_platform_gradle_plugin.md#attaching-sources-in-the-ide) on how to enable downloading sources.
Then, use Navigate | Class... to open the `LspServerManager` class.
In the opened editor, invoke Download IntelliJ Platform sources to download and attach sources.