diff --git a/docs/StardustDocs/cfg/platforms.xml b/docs/StardustDocs/cfg/platforms.xml
new file mode 100644
index 0000000000..c2ea5287fc
--- /dev/null
+++ b/docs/StardustDocs/cfg/platforms.xml
@@ -0,0 +1,12 @@
+
+
+
+ keymap.xml
+
+ primary_macOS
+
+
+ primary_Win-Linux
+
+
+
\ No newline at end of file
diff --git a/docs/StardustDocs/d.tree b/docs/StardustDocs/d.tree
index bd30db31fe..a77d61d6a8 100644
--- a/docs/StardustDocs/d.tree
+++ b/docs/StardustDocs/d.tree
@@ -9,6 +9,9 @@
+
+
+
@@ -193,10 +196,6 @@
-
-
-
-
diff --git a/docs/StardustDocs/images/gettingStarted/df_output.png b/docs/StardustDocs/images/gettingStarted/df_output.png
new file mode 100644
index 0000000000..654fe75382
Binary files /dev/null and b/docs/StardustDocs/images/gettingStarted/df_output.png differ
diff --git a/docs/StardustDocs/images/gettingStarted/df_output_dark.png b/docs/StardustDocs/images/gettingStarted/df_output_dark.png
new file mode 100644
index 0000000000..25641fa2a6
Binary files /dev/null and b/docs/StardustDocs/images/gettingStarted/df_output_dark.png differ
diff --git a/docs/StardustDocs/images/gettingStarted/new_ktn_file.png b/docs/StardustDocs/images/gettingStarted/new_ktn_file.png
new file mode 100644
index 0000000000..41498cee64
Binary files /dev/null and b/docs/StardustDocs/images/gettingStarted/new_ktn_file.png differ
diff --git a/docs/StardustDocs/images/gettingStarted/new_ktn_file_dark.png b/docs/StardustDocs/images/gettingStarted/new_ktn_file_dark.png
new file mode 100644
index 0000000000..323e65d83e
Binary files /dev/null and b/docs/StardustDocs/images/gettingStarted/new_ktn_file_dark.png differ
diff --git a/docs/StardustDocs/images/ktnb_drag_n_drop.mp4 b/docs/StardustDocs/images/ktnb_drag_n_drop.mp4
new file mode 100644
index 0000000000..b6a9bb13d9
Binary files /dev/null and b/docs/StardustDocs/images/ktnb_drag_n_drop.mp4 differ
diff --git a/docs/StardustDocs/keymap.xml b/docs/StardustDocs/keymap.xml
new file mode 100644
index 0000000000..927b8c8878
--- /dev/null
+++ b/docs/StardustDocs/keymap.xml
@@ -0,0 +1,13 @@
+
+
+
+ Settings of Intellij IDEA
+ Cmd+comma
+ Ctrl+Alt+S
+
+
+ Settings of Intellij IDEA
+ Cmd+N
+ Alt+Insert
+
+
\ No newline at end of file
diff --git a/docs/StardustDocs/topics/Home.topic b/docs/StardustDocs/topics/Home.topic
index f484905b01..5db90d5c5d 100644
--- a/docs/StardustDocs/topics/Home.topic
+++ b/docs/StardustDocs/topics/Home.topic
@@ -19,14 +19,14 @@
First steps
-
+
Featured topics
-
+
diff --git a/docs/StardustDocs/topics/gettingStarted.md b/docs/StardustDocs/topics/gettingStarted/gettingStarted.md
similarity index 100%
rename from docs/StardustDocs/topics/gettingStarted.md
rename to docs/StardustDocs/topics/gettingStarted/gettingStarted.md
diff --git a/docs/StardustDocs/topics/gettingStartedDatalore.md b/docs/StardustDocs/topics/gettingStarted/gettingStartedDatalore.md
similarity index 100%
rename from docs/StardustDocs/topics/gettingStartedDatalore.md
rename to docs/StardustDocs/topics/gettingStarted/gettingStartedDatalore.md
diff --git a/docs/StardustDocs/topics/gettingStartedGradle.md b/docs/StardustDocs/topics/gettingStarted/gettingStartedGradle.md
similarity index 100%
rename from docs/StardustDocs/topics/gettingStartedGradle.md
rename to docs/StardustDocs/topics/gettingStarted/gettingStartedGradle.md
diff --git a/docs/StardustDocs/topics/gettingStartedGradleAdvanced.md b/docs/StardustDocs/topics/gettingStarted/gettingStartedGradleAdvanced.md
similarity index 100%
rename from docs/StardustDocs/topics/gettingStartedGradleAdvanced.md
rename to docs/StardustDocs/topics/gettingStarted/gettingStartedGradleAdvanced.md
diff --git a/docs/StardustDocs/topics/gettingStartedJupyterNotebook.md b/docs/StardustDocs/topics/gettingStarted/gettingStartedJupyterNotebook.md
similarity index 100%
rename from docs/StardustDocs/topics/gettingStartedJupyterNotebook.md
rename to docs/StardustDocs/topics/gettingStarted/gettingStartedJupyterNotebook.md
diff --git a/docs/StardustDocs/topics/gettingStarted/gettingStartedKotlinNotebook.md b/docs/StardustDocs/topics/gettingStarted/gettingStartedKotlinNotebook.md
new file mode 100644
index 0000000000..3cf016aa19
--- /dev/null
+++ b/docs/StardustDocs/topics/gettingStarted/gettingStartedKotlinNotebook.md
@@ -0,0 +1,111 @@
+# Get started with Kotlin DataFrame in Kotlin Notebook
+
+
+Use Kotlin DataFrame directly in Kotlin Notebook — write code, explore results, and refine your analysis step by step in a live environment.
+
+
+
+Start analyzing data with Kotlin DataFrame in Kotlin Notebook — live code execution,
+rich tables, and zero configuration required.
+
+
+
+Follow a step-by-step introduction to Kotlin DataFrame in Kotlin Notebook: setup, first DataFrame, and interactive output — all in one place.
+
+
+
+[Kotlin Notebook](https://kotlinlang.org/docs/kotlin-notebook-overview.html) is an interactive environment
+integrated into [IntelliJ IDEA](https://www.jetbrains.com/idea/), designed for fast, iterative,
+and visual data exploration with Kotlin.
+
+The Kotlin Notebook plugin transforms IntelliJ IDEA into a powerful data science workspace,
+combining Kotlin’s strong language features with live code execution,
+interactive data exploration, and rich visualizations
+
+It’s perfect for working with Kotlin DataFrame — letting you write code, view results instantly,
+and refine your analysis step by step.
+
+
+## Create Kotlin Notebook
+
+
+Before version 2025.1, Kotlin Notebook is unavailable in IntelliJ IDEA Community Edition
+and not bundled in IntelliJ IDEA Ultimate Edition by default.
+
+
+* Make sure the [Kotlin Notebook plugin is enabled](https://kotlinlang.org/docs/kotlin-notebook-set-up-env.html).
+
+* Open an IntelliJ IDEA project (either new or existing).
+
+* In the project view, create a new Kotlin Notebook file:
+ Press or right-click the project tree, then select
+ Kotlin Notebook.
+
+{width="200"}
+
+For more details, see
+[Get started with Kotlin Notebook](https://kotlinlang.org/docs/get-started-with-kotlin-notebooks.html)
+on the official [Kotlin Documentation](https://kotlinlang.org/docs/home.html) website.
+
+## Integrate Kotlin DataFrame
+
+In the new notebook file, execute the following cell to add the Kotlin DataFrame library:
+
+```
+%use dataframe
+```
+
+This will load all necessary dependencies, add required imports, and enable rich DataFrame rendering in the notebook.
+
+### Specify a version
+
+By default, if no version is specified, the version bundled with the notebook kernel is used.
+You can explicitly define the version you want:
+
+
+```
+%use dataframe(1.0.0)
+```
+
+Or use the latest stable version of Kotlin DataFrame
+(specified in [Kotlin Jupyter descriptors](https://github.com/Kotlin/kotlin-jupyter-libraries)):
+
+
+```
+%useLatestDescriptors
+%use dataframe
+```
+
+## Hello World
+
+Let’s create your first Kotlin DataFrame in the notebook — a simple "Hello, World!" style example:
+
+```kotlin
+val df = dataFrameOf(
+ "name" to listOf("Alice", "Bob"),
+ "age" to listOf(25, 30)
+)
+```
+
+To display it, run a cell with the `DataFrame` variable in the last line (or simply a cell containing the variable):
+
+```kotlin
+df
+```
+
+You will see the content of this `DataFrame` rendered as an interactive table directly in the cell output:
+
+ {height="168"}
+
+## Next Steps
+
+* Once you’ve successfully set up Kotlin DataFrame in Kotlin Notebook,
+you can move on to the [](quickstart.md)
+ which walks you through the basics of working with DataFrames inside a notebook.
+
+* For more advanced use cases, explore our collection of
+[detailed guides and real-world examples](Guides-And-Examples.md),
+showcasing how Kotlin DataFrame can help with a variety of data tasks.
+
+* Discover powerful [](Kotlin-DataFrame-Features-in-Kotlin-Notebook.md)that
+make exploring and understanding your data easier and more effective.
diff --git a/docs/StardustDocs/topics/gettingStartedKotlinNotebook.md b/docs/StardustDocs/topics/gettingStartedKotlinNotebook.md
deleted file mode 100644
index aa5138e0ef..0000000000
--- a/docs/StardustDocs/topics/gettingStartedKotlinNotebook.md
+++ /dev/null
@@ -1,4 +0,0 @@
-# Get started with Kotlin DataFrame in Kotlin Notebook
-
-TODO
-
diff --git a/docs/StardustDocs/topics/guides/Guides-And-Examples.md b/docs/StardustDocs/topics/guides/Guides-And-Examples.md
index abda61c9e9..712eaf0b68 100644
--- a/docs/StardustDocs/topics/guides/Guides-And-Examples.md
+++ b/docs/StardustDocs/topics/guides/Guides-And-Examples.md
@@ -5,7 +5,7 @@ Browse a collection of guides and examples covering key features and real-world
-Explore Kotlin DataFrame with user guides and real-world examples,
+Explore Kotlin DataFrame with detailed user guides and real-world examples,
showcasing practical use cases and data workflows.
@@ -13,14 +13,67 @@ showcasing practical use cases and data workflows.
A curated list of Kotlin DataFrame guides and examples that walk you through common operations and data analysis patterns step by step.
+
## Guides
-* [Quickstart Guide](quickstart.md) — get started with Kotlin DataFrame in a few simple steps:
+Explore our structured, in-depth guides to steadily improve your Kotlin DataFrame skills — step by step.
+
+* [](quickstart.md) — get started with Kotlin DataFrame in a few simple steps:
load data, transform it, and visualize it.
+* [Enhanced Column Selection DSL](https://blog.jetbrains.com/kotlin/2024/07/enhanced-column-selection-dsl-in-kotlin-dataframe/)
+ — explore powerful DSL for typesafe and flexible column selection in Kotlin DataFrame.
+* [](Kotlin-DataFrame-Features-in-Kotlin-Notebook.md)
+ — discover interactive Kotlin DataFrame outputs in
+[Kotlin Notebook](https://kotlinlang.org/docs/kotlin-notebook-overview.html).
+* [40 Puzzles](https://github.com/Kotlin/dataframe/blob/master/examples/notebooks/puzzles/40%20puzzles.ipynb)
+ — inspired by [100 pandas puzzles](https://github.com/ajcr/100-pandas-puzzles).
+ An interactive guide that takes you from simple tasks to complex challenges,
+teaching you how to solve them using Kotlin DataFrame in a concise and elegant style.
+* [SQL Databases Interaction](readSqlDatabases.md)
+ — set up SQL database access and read query results efficiently into `DataFrame`.
+* [GeoDataFrame Guide](https://kotlin.github.io/kandy/geo-plotting-guide.html)
+ — explore the GeoDataFrame module that brings a convenient Kotlin DataFrame API to geospatial workflows,
+enhanced with beautiful Kandy-Geo visualizations (*experimental*).
+* [OpenAPI Guide](https://github.com/Kotlin/dataframe/blob/master/examples/notebooks/json/KeyValueAndOpenApi.ipynb)
+ — learn how to parse and explore [OpenAPI](https://swagger.io) JSON structures using Kotlin DataFrame,
+enabling structured access and intuitive analysis of complex API schemas (*experimental*).
-
## Examples
-* [Titanic](titanic.md) —
+Explore our extensive collection of practical examples and real-world analytics workflows.
+
+* [Titanic Example](https://github.com/Kotlin/dataframe/blob/master/examples/notebooks/titanic/Titanic.ipynb)
+ — discover the famous "Titanic"
+ dataset with Kotlin DataFrame analysis toolkit
+ and [Kandy](https://kotlin.github.io/kandy/) visualizations.
+
+* [Track and Analyze GitHub Star Growth](https://blog.jetbrains.com/kotlin/2024/08/track-and-analyze-github-star-growth-with-kandy-and-kotlin-dataframe/)
+ — query GitHub’s API with the Kotlin Notebook Ktor client,
+ then analyze and visualize the data using Kotlin DataFrame and [Kandy](https://kotlin.github.io/kandy/).
+
+* [GitHub Example](https://github.com/Kotlin/dataframe/blob/master/examples/notebooks/github/github.ipynb)
+ — a practical example of working with deeply nested, hierarchical DataFrames using GitHub data.
+
+* [Netflix Example](https://github.com/Kotlin/dataframe/blob/master/examples/notebooks/netflix/netflix.ipynb)
+ — explore TV shows and movies from Netflix with the powerful Kotlin Dataframe API and beautiful
+ [Kandy](https://kotlin.github.io/kandy/) visualizations.
+
+* [Top-12 German Companies Financial Analyze](https://github.com/Kotlin/dataframe/blob/master/examples/notebooks/top_12_german_companies)
+ — analyze key financial metrics for several major German companies.
+
+* [Movies Example](https://github.com/Kotlin/dataframe/blob/master/examples/notebooks/movies/movies.ipynb)
+ — basic Kotlin DataFrame operations on data from [movielens](https://movielens.org/).
+
+* [YouTube Example](https://github.com/Kotlin/dataframe/blob/master/examples/notebooks/youtube/Youtube.ipynb)
+ — explore YouTube videos with YouTube REST API and Kotlin Dataframe.
+
+* [IMDb SQL Database Example](https://github.com/zaleslaw/KotlinDataFrame-SQL-Examples/blob/master/notebooks/imdb.ipynb)
+ — analyze IMDb data stored in MariaDB using Kotlin DataFrame
+and visualize with [Kandy](https://kotlin.github.io/kandy/).
+
+
+See also [Kandy User Guides](https://kotlin.github.io/kandy/user-guide.html)
+and [Examples Gallery](https://kotlin.github.io/kandy/examples.html)
+for the best data visualizations using Kotlin DataFrame and Kandy together!
diff --git a/docs/StardustDocs/topics/Usage-with-Kotlin-Notebook-Plugin.md b/docs/StardustDocs/topics/guides/Kotlin-DataFrame-Features-in-Kotlin-Notebook.md
similarity index 90%
rename from docs/StardustDocs/topics/Usage-with-Kotlin-Notebook-Plugin.md
rename to docs/StardustDocs/topics/guides/Kotlin-DataFrame-Features-in-Kotlin-Notebook.md
index a5a07cc6e0..4135110a49 100644
--- a/docs/StardustDocs/topics/Usage-with-Kotlin-Notebook-Plugin.md
+++ b/docs/StardustDocs/topics/guides/Kotlin-DataFrame-Features-in-Kotlin-Notebook.md
@@ -1,9 +1,16 @@
-# Usage with Kotlin Notebook Plugin
+# Kotlin DataFrame Features in Kotlin Notebook
The [Kotlin Notebook Plugin for IntelliJ IDEA](https://plugins.jetbrains.com/plugin/16340-kotlin-notebook),
combined with Kotlin DataFrame, offers powerful data analysis capabilities within an interactive environment.
Here are the key features:
+### Drag-and-Drop Data Files
+
+You can quickly load data into `DataFrame` into a notebook by simply dragging and dropping a file
+(.csv/.json/.xlsx and .geojson/.shp) directly into the notebook editor:
+
+
+
### Visual Data Exploration
**Page through your data**:
The pagination feature lets you move through your data one page at a time, making it possible to view large datasets.
diff --git a/docs/StardustDocs/topics/guides/quickstart.md b/docs/StardustDocs/topics/guides/quickstart.md
index 0a03445380..5840671b03 100644
--- a/docs/StardustDocs/topics/guides/quickstart.md
+++ b/docs/StardustDocs/topics/guides/quickstart.md
@@ -15,7 +15,7 @@ Learn the basics of Kotlin DataFrame: reading data, applying transformations, an
This guide shows how to quickly get started with **Kotlin DataFrame**:
you'll learn how to load data, perform basic transformations, and build a simple plot using Kandy.
-We recommend starting with [**Kotlin Notebook**](gettingStartedKotlinNotebook.md) for the best beginner experience —
+We recommend [starting with **Kotlin Notebook**](gettingStartedKotlinNotebook.md) for the best beginner experience —
everything works out of the box,
including interactivity and rich DataFrame and plots rendering.
You can instantly see the results of each operation: view the contents of your DataFrames after every transformation,
@@ -36,7 +36,7 @@ To start working with Kotlin DataFrame in a notebook, run the cell with the next
```
This will load all necessary DataFrame dependencies (of the latest stable version) and all imports, as well as DataFrame
-rendering. Learn more [here](gettingStartedKotlinNotebook.md).
+rendering. Learn more [here](gettingStartedKotlinNotebook.md#integrate-kotlin-dataframe).
## Read DataFrame