add a plugin example project docs

Author: AndreiKingsley

docs/StardustDocs/topics/Compiler-Plugin.md

@@ -1,9 +1,36 @@
 # Kotlin DataFrame Compiler Plugin
 
-Kotlin DataFrame compiler plugin: available in Gradle projects, is coming to Kotlin Notebook and Maven projects soon.
+<web-summary>
+Explore the Kotlin DataFrame Compiler Plugin —  
+a powerful tool for on-the-fly generating type-safe accessors in DataFrames.
+</web-summary>
+
+<card-summary>
+Explore the Kotlin DataFrame Compiler Plugin —  
+a powerful tool for on-the-fly generating type-safe accessors in DataFrames.
+</card-summary>
+
+<link-summary>
+Explore the Kotlin DataFrame Compiler Plugin —  
+a powerful tool for on-the-fly generating type-safe accessors in DataFrames.
+</link-summary>
+
+
+> Now available in Gradle projects, is coming to Kotlin Notebook and Maven projects soon.
+
+**Kotlin DataFrame Compiler Plugin** is a Kotlin compiler plugin that automatically generates  
+**[type-safe extension properties](extensionPropertiesApi.md)** for your DataFrame,  
+allowing you to access columns and rows in a type-safe way and avoid mistakes in column names.
+
+## Why use it?
+
+- Access columns as regular properties: `df.name` instead of `df["name"]`.
+- Get full IDE and compiler support: autocompletion, refactoring, and type checking.
+- Improve code readability and safety when working with DataFrame.
 
 Check out this video that shows how expressions update the schema of a dataframe: 
-<video src="compiler_plugin.mp4" controls/>
+
+<video src="compiler_plugin.mp4" controls=""/>
 
 ## Setup
 
@@ -111,3 +138,9 @@ fun main() {
 ```
 
 [Learn more](dataSchema.md) about data schema declarations
+
+## Examples
+
+* [Kotlin DataFrame in the IntelliJ IDEA project example](https://github.com/Kotlin/dataframe/blob/master/examples/kotlin-dataframe-plugin-example)  
+  — an IntelliJ IDEA project showcasing simple DataFrame expressions using the Compiler Plugin.
+* [](compilerPluginExamples.md) — few examples of Compiler Plugin usages.

docs/StardustDocs/topics/Home.topic

@@ -28,6 +28,7 @@
         <secondary>
             <title>Featured topics</title>
             <a href="Kotlin-DataFrame-Features-in-Kotlin-Notebook.md"/>
+            <a href="Compiler-Plugin.md"/>
             <a href="readSqlDatabases.md"/>
         </secondary>
 

docs/StardustDocs/topics/compilerPluginExamples.md

@@ -3,6 +3,9 @@
 This page provides a few examples that you can copy directly to your project.
 [Schema info](staticInterpretation.md#schema-info) will be a convenient way to observe the result of different operations.
 
+> See also a [Kotlin DataFrame in the IntelliJ IDEA project example](https://github.com/Kotlin/dataframe/blob/master/examples/kotlin-dataframe-plugin-example) 
+> — an IntelliJ IDEA project showcasing simple DataFrame expressions using the Compiler Plugin.
+
 ### Example 1
 
 ```kotlin

docs/StardustDocs/topics/guides/Guides-And-Examples.md

@@ -56,6 +56,11 @@ Explore our structured, in-depth guides to steadily improve your Kotlin DataFram
 
 Explore our extensive collection of practical examples and real-world analytics workflows.
 
+* [Kotlin DataFrame Compiler Plugin Example](https://github.com/Kotlin/dataframe/blob/master/examples/kotlin-dataframe-plugin-example)  
+  — a simple project demonstrating the usage of the [compiler plugin](Compiler-Plugin.md),  
+  showcasing DataFrame expressions with [extension properties](extensionPropertiesApi.md)  
+  that are generated on-the-fly in the IDEA project.
+
 * [Titanic Example](https://github.com/Kotlin/dataframe/blob/master/examples/notebooks/titanic/Titanic.ipynb)
   — discover the famous "Titanic"
   dataset with the Kotlin DataFrame analysis toolkit

examples/README.md

@@ -1,6 +1,8 @@
 # Examples of Kotlin Dataframe
 
 ### Idea examples
+* [plugin example](kotlin-dataframe-plugin-example) IDEA project with a 
+[Kotlin DataFrame Compiler Plugin](https://kotlin.github.io/dataframe/compiler-plugin.html) example.
 * [movies](idea-examples/movies) Using extension properties [Access API](https://kotlin.github.io/dataframe/apilevels.html) to perform a data cleaning task
 * [titanic](idea-examples/titanic)
 * [youtube](idea-examples/youtube)

examples/kotlin-dataframe-plugin-example/README.md

@@ -0,0 +1,11 @@
+# Kotlin DataFrame Compiler Plugin Example
+
+An IntelliJ IDEA project demonstrating the use of the  
+[Kotlin DataFrame Compiler Plugin](https://kotlin.github.io/dataframe/compiler-plugin.html).
+
+> **Note:** This project uses **dev versions** of the Kotlin and the Kotlin DataFrame plugin.  
+> See [build.gradle.kts](build.gradle.kts) for details.
+
+For proper functionality in IntelliJ IDEA requires version 2025.2 or higher 
+(Currently available only in [IntelliJ IDEA EAP](https://www.jetbrains.com/idea/nextversion/?_gl=1*1ojxffu*_gcl_au*MTk5NzUwODYzOS4xNzQ2NzkxMDMz*_ga*MTE0ODQ1MzY3OS4xNzM4OTY1NzM3*_ga_9J976DJZ68*czE3NDkyMTM4MzkkbzE5OCRnMSR0MTc0OTIxMzg0MSRqNTgkbDAkaDA.)
+).