Remove direct links to deprecated access APIs

Author: koperagen

core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/documentation/AccessApi.kt

@@ -9,11 +9,8 @@ import org.jetbrains.kotlinx.dataframe.documentation.AccessApi.AnyApiLinks
  * or deleted while wrangling. Kotlin, in contrast, is a statically typed language and all types are defined and verified
  * ahead of execution. That's why creating a flexible, handy, and, at the same time, safe API to a dataframe is tricky.
  *
- * In `Kotlin DataFrame` we provide four different ways to access columns, and, while they're essentially different, they
- * look pretty similar in the data wrangling DSL. These include:
+ * In `Kotlin DataFrame` we provide two different ways to access columns:
  * - [Extension Properties API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi.ExtensionPropertiesApi]
- * - [KProperties API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi.KPropertiesApi]
- * - [Column Accessors API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi.ColumnAccessorsApi]
  * - [String API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi.StringApi]
  *
  * For more information: [See Access APIs on the documentation website.](https://kotlin.github.io/dataframe/apilevels.html)
@@ -23,8 +20,6 @@ internal interface AccessApi {
 
     /**
      * - [Extension Properties API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi.ExtensionPropertiesApi]
-     * - [KProperties API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi.KPropertiesApi]
-     * - [Column Accessors API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi.ColumnAccessorsApi]
      * - [String API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi.StringApi]
      */
     interface AnyApiLinks
@@ -59,20 +54,6 @@ internal interface AccessApi {
      * a variable that represents its name and type.
      *
      * For more information: [See Column Accessors API on the documentation website.](https://kotlin.github.io/dataframe/columnaccessorsapi.html)
-     *
-     * For example:
-     * ```kotlin
-     * val survived by column<Boolean>()
-     * val home by column<String>()
-     * val age by column<Int?>()
-     * val name by column<String>()
-     * val lastName by column<String>()
-     *
-     * DataFrame.read("titanic.csv")
-     *     .add(lastName) { name().split(",").last() }
-     *     .dropNulls { age }
-     *     .filter { survived() && home().endsWith("NY") && age()!! in 10..20 }
-     * ```
      */
     interface ColumnAccessorsApi
 
@@ -87,26 +68,6 @@ internal interface AccessApi {
      * The name and type of column should match the name and type of property, respectively.
      *
      * For more information: [See KProperties API on the documentation website.](https://kotlin.github.io/dataframe/kpropertiesapi.html)
-     *
-     * For example:
-     * ```kotlin
-     * data class Passenger(
-     *     val survived: Boolean,
-     *     val home: String,
-     *     val age: Int,
-     *     val lastName: String
-     * )
-     *
-     * val passengers = DataFrame.read("titanic.csv")
-     *     .add(Passenger::lastName) { "name"<String>().split(",").last() }
-     *     .dropNulls(Passenger::age)
-     *     .filter {
-     *         it[Passenger::survived] &&
-     *             it[Passenger::home].endsWith("NY") &&
-     *             it[Passenger::age] in 10..20
-     *     }
-     *     .toListOf<Passenger>()
-     * ```
      */
     interface KPropertiesApi
 
@@ -120,10 +81,15 @@ internal interface AccessApi {
      *
      * For more information: [See Extension Properties API on the documentation website.](https://kotlin.github.io/dataframe/extensionpropertiesapi.html)
      *
-     * For example:
+     * For example, in notebooks extension properties are generated from runtime data after the cell is executed:
      * ```kotlin
      * val df /* : AnyFrame */ = DataFrame.read("titanic.csv")
      * ```
+     * ```kotlin
+     * df.add("lastName") { name.split(",").last() }
+     *     .dropNulls { age }
+     *     .filter { survived && home.endsWith("NY") && age in 10..20 }
+     * ```
      */
     interface ExtensionPropertiesApi
 

core/src/main/kotlin/org/jetbrains/kotlinx/dataframe/documentation/AccessApi.kt

@@ -9,8 +9,7 @@ import org.jetbrains.kotlinx.dataframe.documentation.AccessApi.AnyApiLinks
  * or deleted while wrangling. Kotlin, in contrast, is a statically typed language and all types are defined and verified
  * ahead of execution. That's why creating a flexible, handy, and, at the same time, safe API to a dataframe is tricky.
  *
- * In `Kotlin DataFrame` we provide four different ways to access columns, and, while they're essentially different, they
- * look pretty similar in the data wrangling DSL. These include:
+ * In `Kotlin DataFrame` we provide two different ways to access columns:
  * @include [AnyApiLinks]
  *
  * For more information: {@include [DocumentationUrls.AccessApis]}
@@ -21,8 +20,6 @@ internal interface AccessApi {
 
     /**
      * - {@include [ExtensionPropertiesApiLink]}
-     * - {@include [KPropertiesApiLink]}
-     * - {@include [ColumnAccessorsApiLink]}
      * - {@include [StringApiLink]}
      */
     interface AnyApiLinks
@@ -48,9 +45,6 @@ internal interface AccessApi {
      * a variable that represents its name and type.
      *
      * For more information: {@include [DocumentationUrls.AccessApis.ColumnAccessorsApi]}
-     *
-     * For example: {@comment This works if you include the test module when running KoDEx}
-     * @sample [org.jetbrains.kotlinx.dataframe.samples.api.ApiLevels.accessors3]
      */
     interface ColumnAccessorsApi
 
@@ -65,9 +59,6 @@ internal interface AccessApi {
      * The name and type of column should match the name and type of property, respectively.
      *
      * For more information: {@include [DocumentationUrls.AccessApis.KPropertiesApi]}
-     *
-     * For example: {@comment This works if you include the test module when running KoDEx}
-     * @sample [org.jetbrains.kotlinx.dataframe.samples.api.ApiLevels.kproperties1]
      */
     interface KPropertiesApi
 
@@ -81,8 +72,9 @@ internal interface AccessApi {
      *
      * For more information: {@include [DocumentationUrls.AccessApis.ExtensionPropertiesApi]}
      *
-     * For example: {@comment This works if you include the test module when running KoDEx}
+     * For example, in notebooks extension properties are generated from runtime data after the cell is executed: {@comment This works if you include the test module when running KoDEx}
      * @sample [org.jetbrains.kotlinx.dataframe.samples.api.ApiLevels.extensionProperties1]
+     * @sample [org.jetbrains.kotlinx.dataframe.samples.api.ApiLevels.extensionProperties2]
      */
     interface ExtensionPropertiesApi