2.0 - document how IDE sources are managed

[jonathanlermitage]

Describe the need of your request

Using plugin v2
According to https://plugins.jetbrains.com/docs/intellij/tools-intellij-platform-gradle-plugin-migration.html#intellijdownloadsources:

Downloading sources is managed by the Plugin DevKit plugin in version 2024.1+.

What does it mean exactly? Does it download IDE's sources automatically for stable IDE versions, and not for EAP builds? (this is what I'm trying to do). Plugin v1 offered us to control that. If we lose control when switching to v2, a more detailed documentation would be helpful. Users may not want to download IDE sources when targeting an EAP build, and when running in a CI. I guess this is the default behavior, but I'm not sure. Thx.

Proposed solution

Clarify documentation.

Alternatives you've considered

No response

Additional context

No response

[jansorg]

Currently, with beta6 sources were neither downloaded for stable releases (IC-2024.1.1) nor for EAPs (IC-242.15523.18-EAP-SNAPSHOT). I've enabled Gradle: Download sources in the advanced settings.
It's unclear to me if this is a bug or how I could control the download of sources. I very much would like to get sources for development...