From f15ae38bd9a6f17cfc04afc7ef5560d063bdd5e9 Mon Sep 17 00:00:00 2001 From: Jolan Rensen Date: Mon, 4 May 2026 20:37:55 +0200 Subject: [PATCH 1/3] update gradle plugin deprecation warnings --- docs/StardustDocs/topics/schemas/gradle/Gradle-Plugin.md | 2 +- docs/StardustDocs/topics/schemas/gradle/schemasGradle.md | 2 +- .../topics/schemas/gradle/schemasImportOpenApiGradle.md | 6 +++--- .../topics/schemas/gradle/schemasImportSqlGradle.md | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/StardustDocs/topics/schemas/gradle/Gradle-Plugin.md b/docs/StardustDocs/topics/schemas/gradle/Gradle-Plugin.md index e59a8f4ae3..ce6751a2ba 100644 --- a/docs/StardustDocs/topics/schemas/gradle/Gradle-Plugin.md +++ b/docs/StardustDocs/topics/schemas/gradle/Gradle-Plugin.md @@ -1,6 +1,6 @@ [//]: # (title: Gradle Plugin (deprecated)) -> The current Gradle plugin is **under consideration for deprecation** and may be officially marked as deprecated in future releases. +> The current Gradle plugin is **deprecated**. Its latest release is 1.0.0-Beta4 and will not have future releases. > > At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin. {style="warning"} diff --git a/docs/StardustDocs/topics/schemas/gradle/schemasGradle.md b/docs/StardustDocs/topics/schemas/gradle/schemasGradle.md index 44e75cf569..9ed7716c11 100644 --- a/docs/StardustDocs/topics/schemas/gradle/schemasGradle.md +++ b/docs/StardustDocs/topics/schemas/gradle/schemasGradle.md @@ -2,7 +2,7 @@ -> The current Gradle plugin is **under consideration for deprecation** and may be officially marked as deprecated in future releases. +> The current Gradle plugin is **deprecated**. Its latest release is 1.0.0-Beta4 and will not have future releases. > > At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin. {style="warning"} diff --git a/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md b/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md index 42a1bc3207..7d191b6146 100644 --- a/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md +++ b/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md @@ -2,10 +2,10 @@ -> The current Gradle plugin is **under consideration for deprecation** and may be officially marked as deprecated in future releases. +> The current Gradle plugin is **deprecated**. Its latest release is 1.0.0-Beta4 and will not have future releases. > -> At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin. -{style="warning"} +> At the moment, OpenAPI code generation can be done **[via dedicated methods](OpenAPI.md)** instead of relying on the plugin. +> {style="warning"} OpenAPI 3.0.0 schema support is marked as experimental. It might change or be removed in the future. diff --git a/docs/StardustDocs/topics/schemas/gradle/schemasImportSqlGradle.md b/docs/StardustDocs/topics/schemas/gradle/schemasImportSqlGradle.md index 1ba632b474..0cb52ff0f3 100644 --- a/docs/StardustDocs/topics/schemas/gradle/schemasImportSqlGradle.md +++ b/docs/StardustDocs/topics/schemas/gradle/schemasImportSqlGradle.md @@ -2,7 +2,7 @@ -> The current Gradle plugin is **under consideration for deprecation** and may be officially marked as deprecated in future releases. +> The current Gradle plugin is **deprecated**. Its latest release is 1.0.0-Beta4 and will not have future releases. > > At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin. {style="warning"} From 70039cc7c80133522440e214db148558d66de72b Mon Sep 17 00:00:00 2001 From: Jolan Rensen Date: Mon, 4 May 2026 20:41:20 +0200 Subject: [PATCH 2/3] updated OpenAPI experimental-demotion warning with more useful information --- docs/StardustDocs/topics/dataSources/OpenAPI.md | 6 ++++-- .../topics/schemas/gradle/schemasImportOpenApiGradle.md | 8 +++++--- .../topics/schemas/schemasImportOpenApiJupyter.md | 8 +++++--- 3 files changed, 14 insertions(+), 8 deletions(-) diff --git a/docs/StardustDocs/topics/dataSources/OpenAPI.md b/docs/StardustDocs/topics/dataSources/OpenAPI.md index c8db295c66..19e232fcb1 100644 --- a/docs/StardustDocs/topics/dataSources/OpenAPI.md +++ b/docs/StardustDocs/topics/dataSources/OpenAPI.md @@ -13,8 +13,10 @@ Learn how to use OpenAPI 3.0 JSON schemas with Kotlin DataFrame to load and mani -> **Experimental**: Support for OpenAPI 3.0.0 schemas is currently experimental -> and may change or be removed in future releases. +> **Experimental**: Support for OpenAPI 3.0.0 schemas is demoted to experimental +> and may change or be removed in future releases. This is because OpenAPI 3.1 (and 3.2) have +> introduced significant changes that require specialized handling. +> Follow https://github.com/Kotlin/dataframe/issues/897 for updates and please leave your feedback. > {style="warning"} Kotlin DataFrame provides support for reading and writing JSON data diff --git a/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md b/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md index 7d191b6146..0ca93c9479 100644 --- a/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md +++ b/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md @@ -7,9 +7,11 @@ > At the moment, OpenAPI code generation can be done **[via dedicated methods](OpenAPI.md)** instead of relying on the plugin. > {style="warning"} - -OpenAPI 3.0.0 schema support is marked as experimental. It might change or be removed in the future. - +> **Experimental**: Support for OpenAPI 3.0 schemas is demoted to experimental +> and may change or be removed in future releases. This is because OpenAPI 3.1 (and 3.2) have +> introduced significant changes that require specialized handling. +> Follow [Issue #897](https://github.com/Kotlin/dataframe/issues/897) for updates and please leave your feedback. +> {style="warning"} JSON schema inference is great, but it's not perfect. However, more and more APIs offer [OpenAPI (Swagger)](https://swagger.io/) specifications. diff --git a/docs/StardustDocs/topics/schemas/schemasImportOpenApiJupyter.md b/docs/StardustDocs/topics/schemas/schemasImportOpenApiJupyter.md index 2e41208a61..8b79ed28c9 100644 --- a/docs/StardustDocs/topics/schemas/schemasImportOpenApiJupyter.md +++ b/docs/StardustDocs/topics/schemas/schemasImportOpenApiJupyter.md @@ -2,9 +2,11 @@ - -OpenAPI 3.0.0 schema support is marked as experimental. It might change or be removed in the future. - +> **Experimental**: Support for OpenAPI 3.0.0 schemas is demoted to experimental +> and may change or be removed in future releases. This is because OpenAPI 3.1 (and 3.2) have +> introduced significant changes that require specialized handling. +> Follow https://github.com/Kotlin/dataframe/issues/897 for updates and please leave your feedback. +> {style="warning"} Similar to [importing OpenAPI Data Schemas in Gradle projects](schemasImportOpenApiGradle.md), you can also do this in Kotlin Notebook. From f02f93d403c3ca32a551d6e9554d6c1d225bff2c Mon Sep 17 00:00:00 2001 From: Jolan Rensen Date: Tue, 5 May 2026 15:01:46 +0200 Subject: [PATCH 3/3] added mention of #1844 in gradle-plugin warning messages --- docs/StardustDocs/topics/schemas/gradle/Gradle-Plugin.md | 3 ++- docs/StardustDocs/topics/schemas/gradle/schemasGradle.md | 3 ++- .../topics/schemas/gradle/schemasImportOpenApiGradle.md | 1 + .../topics/schemas/gradle/schemasImportSqlGradle.md | 3 ++- 4 files changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/StardustDocs/topics/schemas/gradle/Gradle-Plugin.md b/docs/StardustDocs/topics/schemas/gradle/Gradle-Plugin.md index ce6751a2ba..ab4a83bc2c 100644 --- a/docs/StardustDocs/topics/schemas/gradle/Gradle-Plugin.md +++ b/docs/StardustDocs/topics/schemas/gradle/Gradle-Plugin.md @@ -3,7 +3,8 @@ > The current Gradle plugin is **deprecated**. Its latest release is 1.0.0-Beta4 and will not have future releases. > > At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin. -{style="warning"} +> Our plans for the next iteration of this feature can be found in [Issue #1844](https://github.com/Kotlin/dataframe/issues/1844). +> {style="warning"} This page describes the Gradle plugin that generates `@DataSchema` from data samples. ```Kotlin diff --git a/docs/StardustDocs/topics/schemas/gradle/schemasGradle.md b/docs/StardustDocs/topics/schemas/gradle/schemasGradle.md index 9ed7716c11..28f8497f0b 100644 --- a/docs/StardustDocs/topics/schemas/gradle/schemasGradle.md +++ b/docs/StardustDocs/topics/schemas/gradle/schemasGradle.md @@ -5,7 +5,8 @@ > The current Gradle plugin is **deprecated**. Its latest release is 1.0.0-Beta4 and will not have future releases. > > At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin. -{style="warning"} +> Our plans for the next iteration of this feature can be found in [Issue #1844](https://github.com/Kotlin/dataframe/issues/1844). +> {style="warning"} In Gradle projects, the Kotlin DataFrame library provides diff --git a/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md b/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md index 0ca93c9479..405762ca20 100644 --- a/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md +++ b/docs/StardustDocs/topics/schemas/gradle/schemasImportOpenApiGradle.md @@ -5,6 +5,7 @@ > The current Gradle plugin is **deprecated**. Its latest release is 1.0.0-Beta4 and will not have future releases. > > At the moment, OpenAPI code generation can be done **[via dedicated methods](OpenAPI.md)** instead of relying on the plugin. +> Our plans for the next iteration of this feature can be found in [Issue #1844](https://github.com/Kotlin/dataframe/issues/1844). > {style="warning"} > **Experimental**: Support for OpenAPI 3.0 schemas is demoted to experimental diff --git a/docs/StardustDocs/topics/schemas/gradle/schemasImportSqlGradle.md b/docs/StardustDocs/topics/schemas/gradle/schemasImportSqlGradle.md index 0cb52ff0f3..50f03946ee 100644 --- a/docs/StardustDocs/topics/schemas/gradle/schemasImportSqlGradle.md +++ b/docs/StardustDocs/topics/schemas/gradle/schemasImportSqlGradle.md @@ -5,7 +5,8 @@ > The current Gradle plugin is **deprecated**. Its latest release is 1.0.0-Beta4 and will not have future releases. > > At the moment, **[data schema generation is handled via dedicated methods](DataSchemaGenerationMethods.md)** instead of relying on the plugin. -{style="warning"} +> Our plans for the next iteration of this feature can be found in [Issue #1844](https://github.com/Kotlin/dataframe/issues/1844). +> {style="warning"} Each SQL database contains the metadata for all the tables. This metadata could be used for the schema generation.