setup gradle update

Author: AndreiKingsley

docs/StardustDocs/d.tree

@@ -14,12 +14,12 @@
         </toc-element>
     </toc-element>
 
-    <toc-element topic="setup.md" accepts-web-file-names="installation.html">
-        <toc-element topic="gettingStartedKotlinNotebook.md"/>
-        <toc-element topic="gettingStartedGradle.md"/>
-        <toc-element topic="gettingStartedJupyterNotebook.md"/>
-        <toc-element topic="gettingStartedDatalore.md"/>
-        <toc-element topic="gettingStartedGradleAdvanced.md"/>
+    <toc-element topic="Setup.md" accepts-web-file-names="installation.html">
+        <toc-element topic="SetupKotlinNotebook.md"/>
+        <toc-element topic="SetupGradle.md"/>
+        <toc-element topic="SetupJupyter.md"/>
+        <toc-element topic="SetupDatalore.md"/>
+        <toc-element topic="SetupAndroid.md"/>
         <toc-element topic="Modules.md"/>
     </toc-element>
     <toc-element topic="concepts.md" accepts-web-file-names="overview.html">

docs/StardustDocs/topics/FAQ.md

@@ -27,7 +27,7 @@ To stay updated on progress, subscribe to the
 Yes — Kotlin DataFrame can be used in Android projects.
 
 There is no dedicated Android artifact yet, but you can include the standard **JVM artifact**  
-by setting up a [custom Gradle configuration](gettingStartedGradleAdvanced.md).
+by setting up a [custom Gradle configuration](SetupAndroid.md).
 
 ## How to start with Kotlin DataFrame ?
 
@@ -41,7 +41,7 @@ to explore various use cases and deepen your understanding of Kotlin DataFrame.
 
 For the best experience, Kotlin DataFrame is most effective in an interactive environment.
 
-- **[Kotlin Notebook](gettingStartedKotlinNotebook.md)** is ideal for exploring Kotlin DataFrame.  
+- **[Kotlin Notebook](SetupKotlinNotebook.md)** is ideal for exploring Kotlin DataFrame.  
   Everything works out of the box — interactivity, rich rendering of DataFrames and plots.  
   You can instantly see the results of each operation, view the contents of your DataFrames after every transformation,  
   inspect individual rows and columns, and explore data step-by-step in a live and interactive way.  
@@ -109,7 +109,7 @@ in a **type-safe** and **name-safe** way.
 
 They are generated automatically when working with Kotlin DataFrame in:
 
-- [Kotlin Notebook](gettingStartedKotlinNotebook.md), where extension properties are generated 
+- [Kotlin Notebook](SetupKotlinNotebook.md), where extension properties are generated 
 after each cell execution.
 - A Kotlin project in [IntelliJ IDEA](https://www.jetbrains.com/idea/) with the
   [](Compiler-Plugin.md) enabled, where the properties are generated at compile time.

docs/StardustDocs/topics/Home.topic

@@ -19,7 +19,7 @@
 
         <primary>
             <title>First steps</title>
-            <a href="gettingStartedKotlinNotebook.md"/>
+            <a href="SetupKotlinNotebook.md"/>
             <a href="concepts.md"/>
             <a href="operations.md"/>
             <a href="read.md">Reading from files: CSV, JSON, ApacheArrow</a>

docs/StardustDocs/topics/collectionsInterop.md

@@ -78,7 +78,7 @@ val df2 = df.add("c") { a + b }
 <tip>
 
 To enable extension properties generation, you should use the [DataFrame plugin](schemasGradle.md) 
-for Gradle or the [Kotlin Jupyter kernel](gettingStartedJupyterNotebook.md)
+for Gradle or the [Kotlin Jupyter kernel](SetupJupyter.md)
 
 </tip>
 

docs/StardustDocs/topics/extensionPropertiesApi.md

@@ -8,7 +8,7 @@ with the name and type of properties inferred from the name and type of the corr
 It also works for all types of hierarchical dataframes.
 
 > The behavior of data schema generation differs between the 
-> [Compiler Plugin](Compiler-Plugin.md) and [Kotlin Notebook](gettingStartedKotlinNotebook.md).
+> [Compiler Plugin](Compiler-Plugin.md) and [Kotlin Notebook](SetupKotlinNotebook.md).
 >
 > * In **Kotlin Notebook**, a schema is generated **only after cell execution** for 
 > `DataFrame` variables defined within that cell.

docs/StardustDocs/topics/gettingStarted/Setup.md

@@ -0,0 +1,36 @@
+[//]: # (title: Setup Kotlin DataFrame)
+
+<web-summary>
+Install Kotlin DataFrame in your preferred environment — Kotlin Notebook, Android, Jupyter, or Datalore 
+— and start working with data right away.
+</web-summary>
+
+<card-summary>
+Install Kotlin DataFrame in your preferred environment — Kotlin Notebook, Gradle, Android, Jupyter, or Datalore 
+— and start working with data right away.
+</card-summary>
+
+<link-summary>
+Step-by-step setup guide for using Kotlin DataFrame in different environments like Kotlin Notebook, Android, and Jupyter.
+</link-summary>
+
+Kotlin DataFrame is supported in multiple environments — choose the one that suits you best and follow the setup steps.
+
+- [**Setup in Kotlin Notebook**](SetupKotlinNotebook.md) — one-line Kotlin DataFrame setup for powerful interactive 
+[Kotlin notebooks in IntelliJ IDEA and Android Studio](https://kotlinlang.org/docs/kotlin-notebook-overview.html). 
+No configuration required, full IDE support.
+Perfect for learning Kotlin DataFrame basics and experimenting, and a great professional tool
+for [data analysis](https://kotlinlang.org/docs/data-analysis-overview.html).
+
+- [**Setup in Gradle**](SetupGradle.md) — add Kotlin DataFrame to your Gradle project for convenient data handling 
+in your Kotlin applications.
+
+- [**Setup on Android**](SetupAndroid.md) — use Kotlin DataFrame in your Android apps to simplify local data processing 
+and transformation.
+
+- [**Setup on Datalore**](SetupDatalore.md) — run Kotlin DataFrame in 
+[JetBrains Datalore](https://www.jetbrains.com/datalore/) notebooks, 
+great for sharing and remote collaboration.
+
+- [**Setup in Jupyter**](SetupJupyter.md) — integrate Kotlin DataFrame 
+into interactive notebooks using the Kotlin Jupyter kernel.

docs/StardustDocs/topics/gettingStarted/gettingStartedGradleAdvanced.md renamed to docs/StardustDocs/topics/gettingStarted/SetupAndroid.md

@@ -1,4 +1,4 @@
-[//]: # (title: Get started with Kotlin DataFrame on Gradle with custom configuration)
+[//]: # (title: Setup Kotlin DataFrame on Android)
 
 ## Gradle
 

docs/StardustDocs/topics/gettingStarted/gettingStartedDatalore.md renamed to docs/StardustDocs/topics/gettingStarted/SetupDatalore.md

@@ -1,4 +1,4 @@
-[//]: # (title: Get started with Kotlin DataFrame on Datalore)
+[//]: # (title: Setup Kotlin DataFrame on Datalore)
 
 ## Datalore
 
@@ -7,7 +7,7 @@ To start with the Kotlin DataFrame library in Datalore, create a Kotlin notebook
 ![Installation in Datalore](datalore-1.png)
 
 As the notebook you've created is a Jupyter Notebook, you can follow the instructions
-in the [previous section](gettingStartedJupyterNotebook.md) to use the Kotlin DataFrame library.
+in the [previous section](SetupJupyter.md) to use the Kotlin DataFrame library.
 The simplest way of doing this is shown in the screenshot:
 
 ![Datalore notebook](datalore-2.png)

docs/StardustDocs/topics/gettingStarted/SetupGradle.md

@@ -0,0 +1,98 @@
+# Setup Kotlin DataFrame in Gradle
+
+Kotlin DataFrame can be added as usual Gradle dependency to your Kotlin project (
+for now only Kotlin/JVM is supported).
+
+## Create a Kotlin project
+
+1. In IntelliJ IDEA, select **File** | **New** | **Project**.
+2. In the panel on the left, select **New Project**.
+3. Name the new project and change its location, if necessary.
+
+   > Select the **Create Git repository** checkbox to place the new project under version control. You can enable this
+   > later at any time.
+   >
+   {type="tip"}
+
+4. From the **Language** list, select **Kotlin**.
+5. Select the **Gradle** build system.
+6. From the **JDK list**, select the [JDK](https://www.oracle.com/java/technologies/downloads/) that you want to use in
+   your project. The minimum supported version is JDK 8.
+    * If the JDK is installed on your computer, but not defined in the IDE, select **Add JDK** and specify the path to the
+      JDK home directory.
+    * If you don't have the necessary JDK on your computer, select **Download JDK**.
+7. From the **Gradle DSL** list, select **Kotlin** or **Groovy**.
+8. Select the **Add sample code** checkbox to create a file with a sample `"Hello World!"` application.
+9. Click **Create**.
+
+You have successfully created a project with Gradle.
+
+## Add Kotlin DataFrame Gradle dependency
+
+In your Gradle build file (`build.gradle` or `build.gradle.kts`), add the Kotlin DataFrame library as a dependency:
+
+<tabs>
+<tab title="Kotlin DSL">
+
+```kotlin
+dependencies {
+    implementation("org.jetbrains.kotlinx:dataframe:%dataFrameVersion%")
+}
+```
+
+</tab>
+
+<tab title="Groovy DSL">
+
+```groovy
+dependencies {
+    implementation 'org.jetbrains.kotlinx:dataframe:%dataFrameVersion%'
+}
+```
+
+</tab>
+
+</tabs>
+
+This will add [general Kotlin DataFrame dependency](Modules.md#dataframe-general), i.e., 
+[core API and implementation](Modules.md#dataframe-core) 
+as well as all [IO modules](Modules.md#io-modules) 
+(excluding [experimental ones](Modules.md#experimental-modules)). 
+For flexible dependencies configuration see [Custom configuration](#custom-configuration).
+
+### Add imports
+
+In `src/main/kotlin/Main.kt`, add the following imports at the top of the file:
+
+```kotlin
+import org.jetbrains.kotlinx.dataframe.DataFrame
+import org.jetbrains.kotlinx.dataframe.io.*
+import org.jetbrains.kotlinx.dataframe.api.*
+```
+
+## Hello World
+
+Let’s create your first [`DataFrame`](DataFrame.md) in the notebook — a simple "Hello, World!" style example:
+
+```kotlin
+import org.jetbrains.kotlinx.dataframe.api.dataFrameOf
+
+fun main() {
+    val df = dataFrameOf(
+        "name" to listOf("Alice", "Bob"),
+        "age" to listOf(25, 30)
+    )
+
+    println(df)
+}
+```
+
+Congratulations! You have successfully used the Kotlin DataFrame library to import, manipulate and export data.
+
+
+## Custom configuration
+
+## Next steps
+* Learn more about how to [import and export data](io.md)
+* Learn about our different [access APIs](apiLevels.md)
+* Explore the many different [operations that you can perform](operations.md)

docs/StardustDocs/topics/gettingStarted/gettingStartedJupyterNotebook.md renamed to docs/StardustDocs/topics/gettingStarted/SetupJupyter.md

@@ -1,4 +1,4 @@
-[//]: # (title: Get started with Kotlin DataFrame on Jupyter Notebook)
+[//]: # (title: Setup Kotlin DataFrame in Jupyter)
 
 ## Jupyter Notebook