updating OpenAPI docs on website

Author: Jolanrensen

docs/StardustDocs/topics/gettingStartedGradleAdvanced.md

@@ -128,8 +128,11 @@ dependencies {
     implementation("org.jetbrains.kotlinx:dataframe-excel:%dataFrameVersion%")
     implementation("org.jetbrains.kotlinx:dataframe-jdbc:%dataFrameVersion%")
     implementation("org.jetbrains.kotlinx:dataframe-arrow:%dataFrameVersion%")
+
+    // experimental
     implementation("org.jetbrains.kotlinx:dataframe-openapi:%dataFrameVersion%")
 
+    // experimental
     // This artifact is only needed to directly call functions that generate @DataSchema code from OpenAPI specifications
     // It's used by Gradle and KSP plugins internally.
     // Your project needs dataframe-openapi to use generated code
@@ -149,7 +152,14 @@ dependencies {
     implementation 'org.jetbrains.kotlinx:dataframe-excel:%dataFrameVersion%'
     implementation 'org.jetbrains.kotlinx:dataframe-jdbc:%dataFrameVersion%'
     implementation 'org.jetbrains.kotlinx:dataframe-arrow:%dataFrameVersion%'
+
+    // experimental
     implementation 'org.jetbrains.kotlinx:dataframe-openapi:%dataFrameVersion%'
+
+    // experimental
+    // This artifact is only needed to directly call functions that generate @DataSchema code from OpenAPI specifications
+    // It's used by Gradle and KSP plugins internally.
+    // Your project needs dataframe-openapi to use generated code
     implementation 'org.jetbrains.kotlinx:dataframe-openapi-generator:%dataFrameVersion%'
 }
 ```

docs/StardustDocs/topics/schemas.md

@@ -38,9 +38,9 @@ Here's a list of the most popular use cases with Data Schemas.
 * [**Schema Definitions from SQL Databases in Gradle Project**](schemasImportSqlGradle.md) <br/>
   When you need to take data from the SQL database.
 
-* [**Import OpenAPI Schemas in Gradle Project**](schemasImportOpenApiGradle.md) <br/>
+* [**Import OpenAPI 3.0.0 Schemas (Experimental) in Gradle Project**](schemasImportOpenApiGradle.md) <br/>
   When you need to take data from the endpoint with OpenAPI Schema.
 
-* [**Import Data Schemas, e.g. from OpenAPI, in Jupyter**](schemasImportOpenApiJupyter.md) <br/>
+* [**Import Data Schemas, e.g. from OpenAPI 3.0.0 (Experimental), in Jupyter**](schemasImportOpenApiJupyter.md) <br/>
   Similar to [importing OpenAPI Data Schemas in Gradle projects](schemasImportOpenApiGradle.md), 
   you can also do this in Jupyter Notebooks.

docs/StardustDocs/topics/schemasImportOpenApiGradle.md

@@ -1,7 +1,11 @@
-[//]: # (title: Import OpenAPI Schemas in Gradle project)
+[//]: # (title: Import OpenAPI Schemas in Gradle project (Experimental))
 
 <!---IMPORT org.jetbrains.kotlinx.dataframe.samples.api.Schemas-->
 
+<warning>
+OpenAPI 3.0.0 schema support is marked as experimental. It might change or be removed in the future.
+</warning>
+
 JSON schema inference is great, but it's not perfect. However, more and more APIs offer
 [OpenAPI (Swagger)](https://swagger.io/) specifications. 
 

docs/StardustDocs/topics/schemasImportOpenApiJupyter.md

@@ -2,8 +2,14 @@
 
 <!---IMPORT org.jetbrains.kotlinx.dataframe.samples.api.Schemas-->
 
+<warning>
+OpenAPI 3.0.0 schema support is marked as experimental. It might change or be removed in the future.
+</warning>
+
 Similar to [importing OpenAPI Data Schemas in Gradle projects](schemasImportOpenApiGradle.md),
-you can also do this in Jupyter Notebooks. 
+you can also do this in Jupyter Notebooks.
+This requires enabling the `enableExperimentalOpenApi` setting, like:
+```%use dataframe(..., enableExperimentalOpenApi=true)```.
 
 There is only a slight difference in notation: