Merge pull request #1323 from Kotlin/docs_update

Docs small fixes

Author: AndreiKingsley

docs/StardustDocs/d.tree

@@ -188,6 +188,9 @@
             <toc-element topic="jupyterRendering.md"/>
         </toc-element>
     </toc-element>
+    <toc-element topic="Data-Sources.md" hidden="true">
+        <toc-element topic="Integrations.md" hidden="true"/>
+    </toc-element>
     <toc-element topic="_shadow_resources.md" hidden="true"/>
     <toc-element topic="Support.md"/>
     <toc-element topic="FAQ.md"/>

docs/StardustDocs/topics/FAQ.md

@@ -172,6 +172,14 @@ and examples with beautiful [Kandy](https://kotlin.github.io/kandy) geo visualiz
 
 ## What is the difference between Compiler Plugin, Gradle Plugin, and KSP Plugin?
 
+> The current Gradle plugin is **under consideration for deprecation** and may be officially marked as deprecated 
+> in future releases.
+> The KSP plugin doesn't work for now.
+>
+> At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead 
+> of relying on the plugins.
+{style="warning"}
+
 All these plugins relate to working with [dataframe schemas](schemas.md), but they serve different purposes:
 
 - **[Gradle Plugin](DataSchemaGenerationGradle.md)** and **[KSP Plugin](https://github.com/Kotlin/dataframe/tree/master/plugins/symbol-processor)** 

docs/StardustDocs/topics/concepts/DataSchemaGenerationGradle.md

@@ -1,5 +1,10 @@
 [//]: # (title: Data Shemas Generation in Gradle)
 
+> The current Gradle plugin is **under consideration for deprecation** and may be officially marked as deprecated in future releases.
+>
+> At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin.
+{style="warning"}
+
 This page describes the Gradle plugin that generates `@DataSchema` from data samples.
 ```Kotlin
 id("org.jetbrains.kotlinx.dataframe") version "%dataFrameVersion%"

docs/StardustDocs/topics/concepts/schemasGradle.md

@@ -2,6 +2,11 @@
 
 <!---IMPORT org.jetbrains.kotlinx.dataframe.samples.api.Schemas-->
 
+> The current Gradle plugin is **under consideration for deprecation** and may be officially marked as deprecated in future releases.
+>
+> At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin.
+{style="warning"}
+
 In Gradle projects, the Kotlin DataFrame library provides
 
 1. Annotation processing for generation of extension properties

docs/StardustDocs/topics/concepts/schemasImportOpenApiGradle.md

@@ -2,6 +2,11 @@
 
 <!---IMPORT org.jetbrains.kotlinx.dataframe.samples.api.Schemas-->
 
+> The current Gradle plugin is **under consideration for deprecation** and may be officially marked as deprecated in future releases.
+>
+> At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin.
+{style="warning"}
+
 <warning>
 OpenAPI 3.0.0 schema support is marked as experimental. It might change or be removed in the future.
 </warning>

docs/StardustDocs/topics/concepts/schemasImportSqlGradle.md

@@ -2,6 +2,11 @@
 
 <!---IMPORT org.jetbrains.kotlinx.dataframe.samples.api.Schemas-->
 
+> The current Gradle plugin is **under consideration for deprecation** and may be officially marked as deprecated in future releases.
+>
+> At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin.
+{style="warning"}
+
 Each SQL database contains the metadata for all the tables. 
 This metadata could be used for the schema generation.
 

docs/StardustDocs/topics/dataSources/Data-Sources.md

@@ -0,0 +1,3 @@
+# Data Sources
+
+> This topic is not ready yet.

docs/StardustDocs/topics/dataSources/Integrations.md

@@ -0,0 +1,3 @@
+# Integrations
+
+> This topic is not ready yet.

docs/StardustDocs/topics/gettingStarted/Modules.md

@@ -508,6 +508,11 @@ Published as a Kotlin official plugin.
 
 #### `kotlinx.dataframe` – Gradle Plugin {id="kotlinx.dataframe"}
 
+> The current Gradle plugin is **under consideration for deprecation** and may be officially marked as deprecated in future releases.
+>
+> At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin.
+{style="warning"}
+
 The Gradle plugin allows generating [data schemas](schemas.md) from samples of data  
 (of supported formats) like JSON, CSV, Excel files, or URLs, as well as from data fetched from SQL databases  
 using Gradle.
@@ -517,6 +522,7 @@ and usage instructions in Gradle projects.
 
 > By default, the Gradle plugin also applies the [KSP plugin](#ksp-plugin).
 
+
 <tabs>
 <tab title="Kotlin DSL">
 
@@ -540,6 +546,11 @@ plugins {
 
 #### `kotlinx.dataframe:symbol-processor-all` – KSP Plugin {id="ksp-plugin"}
 
+> Doesn't work for now.
+> 
+> At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin.
+{style="warning"}
+
 The Gradle plugin allows generating [data schemas](schemas.md) from samples of data  
 (of supported formats) like JSON, CSV, Excel files, or URLs, as well as from data fetched from SQL databases  
 using Kotlin Symbol Processing (KSP).