IntelliJ Platform Gradle Plugin (2.X) first page only #1357
Conversation
| @@ -27,7 27,8 @@ It is a successor of _[](tools_gradle_intellij_plugin.md)_. | |||
|
|
|||
| ## Requirements | |||
|
|
|||
| IntelliJ Platform Gradle Plugin 2.x requires the following minimal versions: | |||
| IntelliJ Platform Gradle Plugin 2.x requires the following **minimal versions**: | |||
There was a problem hiding this comment.
I made the minimal in bold, but I think it will be better to write the ' ' or "and above" next to each requirement
| } | ||
| ``` | ||
|
|
||
| To apply the IntelliJ Platform Gradle Plugin to a project, you need to add the following: |
There was a problem hiding this comment.
I'm not sure, but I think the user needs to add the gradle portal repository to use the plugin. If I am wrong, this can be reverted.
|
|
||
| ### Snapshot Release | ||
|
|
||
| To use the latest snapshot versions, add the following to the <path>settings.gradle.kts</path> file: | ||
| To use the latest snapshot versions of this plugin, add the following to the <path>settings.gradle.kts</path> file: |
There was a problem hiding this comment.
Between all the definitions and usages of IJ target products and builds with snapshots and releases, this sentence should emphasize that we are talking here about the plugin version
| ### Attaching Sources | ||
|
|
||
| To attach IntelliJ Platform sources in the IDE, the <control>Download sources</control> setting has to be enabled in IDE versions 2023.2 and later. | ||
| This option respects the [](tools_intellij_platform_gradle_plugin_gradle_properties.md#downloadSources) property, which is enabled by default. | ||
|
|
||
| <tabs> | ||
|
|
||
| <tab title="Earlier versions"> |
There was a problem hiding this comment.
I thought those should be in chronological order since it started with the 2023.3 tab and then a tab of 2023.2, and jumping to the earlier version is a bit confusing.
There was a problem hiding this comment.
It is in chronological order. Latest version on the left, oldest on the right; this is also consistent with all other such tabs in docs. We assume that plugin developer always upgrade to new IDEs ASAP.
There was a problem hiding this comment.
You're right.
Sorry - I don't know why I thought "Earlier versions" refers to the "newer" version instead of "older" , and I missed the next to the 2023.3
| </tabs> | ||
|
|
||
| The attaching sources is handed by the Plugin DevKit plugin thus it's recommended to use always the latest available IDE release. | ||
| The attaching sources operation in the IDE is handled by the Plugin DevKit plugin thus it's always recommended to use the latest available IDE release. |
There was a problem hiding this comment.
I found this a bit unclear.
The DevKit plugin handled the attaching sources so it is recommended to use the latest plugin version available or the latest IDE release?
Hi
This PR only contains changes on the IntelliJ Platform Gradle Plugin (2.X) page.
Those are my general suggestions and opinions (feel free to disagree 😄 ):
It can start with a note and a link to users who are migrating from previous version pages, but it should not mention migration and 1.X more than that.