Merge pull request #1179 from Kotlin/website_docs_examples_dev

Website docs examples dev

Author: AndreiKingsley

docs/StardustDocs/d.tree

@@ -196,7 +196,6 @@
     <toc-element topic="Usage-with-Kotlin-Notebook-Plugin.md">
         <toc-element topic="Trobleshooting.md"/>
     </toc-element>
-    <toc-element href="https://github.com/Kotlin/dataframe/tree/master/examples" toc-title="Examples"/>
     <toc-element topic="Compiler-Plugin.md"/>
     <toc-element topic="_shadow_resources.md" hidden="true"/>
     <toc-element topic="_shadow_resources_snippets.md" hidden="true"/>

docs/StardustDocs/topics/_shadow_resources.md

@@ -9,4 +9,4 @@
 <resource src="notebook_test_quickstart_5.html"></resource>
 <resource src="notebook_test_quickstart_12.html"></resource>
 <resource src="notebook_test_quickstart_3.html"></resource>
-<resource src="notebook_test_quickstart_14.html"></resource>
+<resource src="notebook_test_quickstart_14.html"></resource>

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

@@ -5,22 +5,72 @@ Browse a collection of guides and examples covering key features and real-world
 </web-summary>
 
 <card-summary>
-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.
 </card-summary>
 
 <link-summary>
 A curated list of Kotlin DataFrame guides and examples that walk you through common operations and data analysis patterns step by step.
 </link-summary>
 
+<!--- TODO: add more guides (migration from pandas and others) and replace GH notebooks with topics --->
 
 ## Guides
 
+Explore our structured, in-depth guides to steadily improve your Kotlin DataFrame skills — step by step.
+
 * [Quickstart Guide](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.
+* [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*, supports OpenAPI 3.0.0).
 
-<!--- TODO: add more guides. --->
 
 ## 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 the 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!