rework installation

Author: koperagen

docs/StardustDocs/topics/installation.md

@@ -30,7 +30,7 @@ If you want to always use the latest version, add another magic before `%use dat
 If you want to use specific version of the Kotlin DataFrame library, you can specify it in brackets:
 
 ```text
-%use dataframe(0.8.1)
+%use dataframe(%dataFrameVersion%)
 ```
 
 After loading, all essential types will be already imported, so you can start using the Kotlin DataFrame library. Enjoy!
@@ -52,45 +52,57 @@ The simplest way of doing this is shown on screenshot:
 The Kotlin DataFrame library is published to Maven Central, so you can simply add the following line to your Kotlin DSL
 buildscript to depend on it:
 
-### All-in-one artifact
+### General configuration
 
 <tabs>
 <tab title="Kotlin DSL">
 
 ```kotlin
+plugins {
+    id("org.jetbrains.kotlinx.dataframe") version "%dataFrameVersion%"
+}
+
 dependencies {
-    implementation("org.jetbrains.kotlinx:dataframe:<version>")
+    implementation("org.jetbrains.kotlinx:dataframe:%dataFrameVersion%")
 }
 ```
 
 </tab>
 
 <tab title="Groovy DSL">
 
-```kotlin
+```groovy
+plugins {
+    id("org.jetbrains.kotlinx.dataframe") version "%dataFrameVersion%"
+}
+
 dependencies {
-    implementation 'org.jetbrains.kotlinx:dataframe:<version>'
+    implementation 'org.jetbrains.kotlinx:dataframe:%dataFrameVersion%'
 }
 ```
 
 </tab>
 
 </tabs>
 
-### Only what you need
+Note that it's better to use the same version for a library and plugin to avoid unpredictable errors.
+After plugin configuration you can try it out with [example](gradle.md#annotation-processing).
+
+### Custom configuration
 
-If you want to avoid adding unnecessary dependency, you can choose whatever you need:
+If you want to avoid adding unnecessary dependency, you can choose from following artifacts:
 
 <tabs>
 <tab title="Kotlin DSL">
 
 ```kotlin
 dependencies {
     // Artifact containing all APIs and implementations
-    implementation("org.jetbrains.kotlinx:dataframe-core:<version>")
+    implementation("org.jetbrains.kotlinx:dataframe-core:%dataFrameVersion%")
     // Optional formats support
-    implementation("org.jetbrains.kotlinx:dataframe-excel:<version>")
-    implementation("org.jetbrains.kotlinx:dataframe-arrow:<version>")
+    implementation("org.jetbrains.kotlinx:dataframe-excel:%dataFrameVersion%")
+    implementation("org.jetbrains.kotlinx:dataframe-arrow:%dataFrameVersion%")
+    implementation("org.jetbrains.kotlinx:dataframe-openapi:%dataFrameVersion%")
 }
 ```
 
@@ -101,38 +113,27 @@ dependencies {
 ```groovy
 dependencies {
     // Artifact containing all APIs and implementations
-    implementation 'org.jetbrains.kotlinx:dataframe-core:<version>'
+    implementation 'org.jetbrains.kotlinx:dataframe-core:%dataFrameVersion%'
     // Optional formats support 
-    implementation 'org.jetbrains.kotlinx:dataframe-excel:<version>'
-    implementation 'org.jetbrains.kotlinx:dataframe-arrow:<version>'
+    implementation 'org.jetbrains.kotlinx:dataframe-excel:%dataFrameVersion%'
+    implementation 'org.jetbrains.kotlinx:dataframe-arrow:%dataFrameVersion%'
+    implementation 'org.jetbrains.kotlinx:dataframe-openapi:%dataFrameVersion%'
 }
 ```
 
 </tab>
 
 </tabs>
 
-### Data schema preprocessor
+#### Linter configuration
 
 We provide a Gradle plugin that generates interfaces by your data.
-To use it in your project, pick up the latest version from [here](https://plugins.gradle.org/plugin/org.jetbrains.kotlinx.dataframe)
-and follow the configuration:
+Use this configuration to prevent linter from complaining about formatting in the generated sources.
 
 <tabs>
 <tab title="Kotlin DSL">
 
 ```kotlin
-plugins {
-    id("org.jetbrains.kotlinx.dataframe") version "<version>"
-}
-
-dependencies {
-    implementation("org.jetbrains.kotlinx:dataframe:<version>")
-}
-
-// Make IDE aware of the generated code:
-kotlin.sourceSets.getByName("main").kotlin.srcDir("build/generated/ksp/main/kotlin/")
-
 // (Only if you use kotlint) Excludes for `kotlint`:
 tasks.withType<org.jmailen.gradle.kotlinter.tasks.LintTask> {
     exclude {
@@ -149,18 +150,6 @@ tasks.withType<org.jmailen.gradle.kotlinter.tasks.LintTask> {
 <tab title="Groovy DSL">
 
 ```groovy
-plugins {
-    id("org.jetbrains.kotlinx.dataframe") version "<version>"
-}
-
-dependencies {
-    implementation("org.jetbrains.kotlinx:dataframe:<version>")
-}
-
-// Make IDE aware of the generated code:
-kotlin.sourceSets.getByName("main").kotlin.srcDir("build/generated/ksp/main/kotlin/")
-
-// (Only if you use kotlint) Excludes for `kotlint`:
 tasks.withType(org.jmailen.gradle.kotlinter.tasks.LintTask).all {
     exclude {
         it.name.endsWith(".Generated.kt")
@@ -173,50 +162,8 @@ tasks.withType(org.jmailen.gradle.kotlinter.tasks.LintTask).all {
 
 </tab>
 
-<tab title="Multiplatform (JVM target Only)">
-
-```kotlin
-plugins {
-    id("org.jetbrains.kotlinx.dataframe") version "<version>"
-}
-
-kotlin {
-    jvm()
-    sourceSets {
-        val jvmMain by getting {
-            // Make IDE aware of the generated code:
-            kotlin.srcDir("build/generated/ksp/jvmMain/kotlin/")
-            dependencies {
-                implementation("org.jetbrains.kotlinx:dataframe:<version>")
-            }
-        }
-    }
-}
-
-// (Only if you use kotlint) Excludes for `kotlint`:
-tasks.withType<org.jmailen.gradle.kotlinter.tasks.LintTask> {
-    exclude {
-        it.name.endsWith(".Generated.kt")
-    }
-    exclude {
-        it.name.endsWith("\$Extensions.kt")
-    }
-}
-```
-
-</tab>
-
 </tabs>
 
-<note>
-
-If the code generated by the plugin isn't resolved in IDE, make sure you've configured source sets according to the snippet above. More information in [KSP documentation](https://github.com/google/ksp/blob/main/docs/quickstart.md#make-ide-aware-of-generated-code)
-
-</note>
-
-Note that it's better to use the same version for a library and plugin to avoid unpredictable errors.
-After plugin configuration you can try it out with [example](gradle.md#annotation-processing).
-
 ## Other build systems
 
 If you are using Maven, Ivy or Bazel to configure your build, you can still use the Kotlin DataFrame library in your project.