fixed documentation urls

Author: Jolanrensen

core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/ColumnsSelectionDsl.kt

@@ -39,7 +39,7 @@ public annotation class ColumnsSelectionDslMarker
  * Select or express columns using the [Columns Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl].
  * (Any (combination of) [Access API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi]).
  *
- * This DSL comes in the form a [Columns Selector][org.jetbrains.kotlinx.dataframe.ColumnsSelector] lambda,
+ * This DSL is initiated by a [Columns Selector][org.jetbrains.kotlinx.dataframe.ColumnsSelector] lambda,
  * which operates on the [Columns Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl] and
  * expects you to return a [ColumnsResolver][org.jetbrains.kotlinx.dataframe.columns.ColumnsResolver]; an entity formed by calling any (combination) of the functions
  * in the DSL that is or can be resolved into one or more columns.
@@ -51,11 +51,11 @@ public annotation class ColumnsSelectionDslMarker
  *
  * #### For example:
  *
- * `df.`select` { length `[and][org.jetbrains.kotlinx.dataframe.api.AndColumnsSelectionDsl.and]` age }`
+ * `df.`[select][DataFrame.select]` { length `[and][org.jetbrains.kotlinx.dataframe.api.AndColumnsSelectionDsl.and]` age }`
  *
- * `df.`select` { `[cols][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl.cols]`(1..5) }`
+ * `df.`[select][DataFrame.select]` { `[cols][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl.cols]`(1..5) }`
  *
- * `df.`select` { `[colsOf][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl.colsOf]`<`[Double][Double]`>() }`
+ * `df.`[select][DataFrame.select]` { `[colsOf][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl.colsOf]`<`[Double][Double]`>() }`
  *
  *
  *

core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/Nulls.kt

@@ -145,7 +145,7 @@ private interface UpdateWithNote
  *
  * ### Check out: [Usage][org.jetbrains.kotlinx.dataframe.api.Update.Usage]
  *
- * For more information: [See Column Selectors on the documentation website.](https://kotlin.github.io/dataframe/update.html) 
+ * For more information: [See `update` on the documentation website.](https://kotlin.github.io/dataframe/update.html) 
  *
  *     
  *
@@ -154,7 +154,7 @@ private interface UpdateWithNote
  * Select or express columns using the [Columns Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl].
  * (Any (combination of) [Access API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi]).
  *
- * This DSL comes in the form a [Columns Selector][org.jetbrains.kotlinx.dataframe.ColumnsSelector] lambda,
+ * This DSL is initiated by a [Columns Selector][org.jetbrains.kotlinx.dataframe.ColumnsSelector] lambda,
  * which operates on the [Columns Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl] and
  * expects you to return a [ColumnsResolver][org.jetbrains.kotlinx.dataframe.columns.ColumnsResolver]; an entity formed by calling any (combination) of the functions
  * in the DSL that is or can be resolved into one or more columns.

core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/update.kt

@@ -2,11 +2,6 @@ package org.jetbrains.kotlinx.dataframe.documentation
 
 internal interface DocumentationUrls {
 
-    interface NameArg
-
-    /** See {@getArg [NameArg]} on the documentation website. */
-    interface Text
-
     /** https://kotlin.github.io/dataframe */
     interface Url
 

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

@@ -38,7 +38,7 @@ internal interface SelectingColumnsLink
  * Select or express columns using the [Columns Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl].
  * (Any (combination of) [Access API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi]).
  *
- * This DSL comes in the form a [Columns Selector][org.jetbrains.kotlinx.dataframe.ColumnsSelector] lambda,
+ * This DSL is initiated by a [Columns Selector][org.jetbrains.kotlinx.dataframe.ColumnsSelector] lambda,
  * which operates on the [Columns Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl] and
  * expects you to return a [ColumnsResolver][org.jetbrains.kotlinx.dataframe.columns.ColumnsResolver]; an entity formed by calling any (combination) of the functions
  * in the DSL that is or can be resolved into one or more columns.
@@ -103,7 +103,7 @@ internal interface SelectingColumns {
      * Select or express columns using the [Columns Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl].
      * (Any (combination of) [Access API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi]).
      *
-     * This DSL comes in the form a [Columns Selector][ColumnsSelector] lambda,
+     * This DSL is initiated by a [Columns Selector][ColumnsSelector] lambda,
      * which operates on the [Columns Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl] and
      * expects you to return a [ColumnsResolver]; an entity formed by calling any (combination) of the functions
      * in the DSL that is or can be resolved into one or more columns.
@@ -119,7 +119,7 @@ internal interface SelectingColumns {
          * Select or express columns using the [Columns Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl].
          * (Any (combination of) [Access API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi]).
          *
-         * This DSL comes in the form a [Columns Selector][org.jetbrains.kotlinx.dataframe.ColumnsSelector] lambda,
+         * This DSL is initiated by a [Columns Selector][org.jetbrains.kotlinx.dataframe.ColumnsSelector] lambda,
          * which operates on the [Columns Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnsSelectionDsl] and
          * expects you to return a [ColumnsResolver][org.jetbrains.kotlinx.dataframe.columns.ColumnsResolver]; an entity formed by calling any (combination) of the functions
          * in the DSL that is or can be resolved into one or more columns.
@@ -149,7 +149,7 @@ internal interface SelectingColumns {
      * Select or express a single column using the Column Selection DSL.
      * (Any [Access API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi]).
      *
-     * This DSL comes in the form of a [Column Selector][ColumnSelector] lambda,
+     * This DSL is initiated by a [Column Selector][ColumnSelector] lambda,
      * which operates in the [Column Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnSelectionDsl] and
      * expects you to return a [SingleColumn].
      *
@@ -164,7 +164,7 @@ internal interface SelectingColumns {
          * Select or express a single column using the Column Selection DSL.
          * (Any [Access API][org.jetbrains.kotlinx.dataframe.documentation.AccessApi]).
          *
-         * This DSL comes in the form of a [Column Selector][org.jetbrains.kotlinx.dataframe.ColumnSelector] lambda,
+         * This DSL is initiated by a [Column Selector][org.jetbrains.kotlinx.dataframe.ColumnSelector] lambda,
          * which operates in the [Column Selection DSL][org.jetbrains.kotlinx.dataframe.api.ColumnSelectionDsl] and
          * expects you to return a [SingleColumn][org.jetbrains.kotlinx.dataframe.columns.SingleColumn].
          *

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

@@ -37,7 +37,7 @@ public annotation class ColumnsSelectionDslMarker
 /**
  * ## Columns Selection DSL
  * {@include [SelectingColumns.Dsl.WithExample]}
- * {@setArg [SelectingColumns.OperationArg] select}
+ * {@setArg [SelectingColumns.OperationArg] [select][DataFrame.select]}
  *
  * @comment This interface be safely cast to [SingleColumn] across the library. It does not directly
  * implement it for DSL purposes.

core/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/ColumnsSelectionDsl.kt

@@ -34,7 +34,7 @@ private interface SetFillNullsOperationArg
  * @include [LineBreak]
  * @include [Update.Columns] {@comment Description of what this function expects the user to do: select columns}
  *
- * ## This Fill Nulls Overload
+ * ### This Fill Nulls Overload
  *
  */
 private interface CommonFillNullsFunctionDoc
@@ -118,7 +118,7 @@ internal interface SetFillNaNsOperationArg
  * @include [FillNaNs] {@comment Description of the fillNaNs operation.}
  * @include [LineBreak]
  * @include [Update.Columns] {@comment Description of what this function expects the user to do: select columns}
- * ## This Fill NaNs Overload
+ * ### This Fill NaNs Overload
  */
 private interface CommonFillNaNsFunctionDoc
 
@@ -181,7 +181,7 @@ internal interface SetFillNAOperationArg
  * @include [FillNA] {@comment Description of the fillNA operation.}
  * @include [LineBreak]
  * @include [Update.Columns] {@comment Description of what this function expects the user to do: select columns}
- * ## This Fill NA Overload
+ * ### This Fill NA Overload
  */
 private interface CommonFillNAFunctionDoc
 
@@ -259,7 +259,7 @@ private interface SetDropNullsOperationArg
 
 /**
  * @include [DropNulls] {@comment Description of the dropNulls operation.}
- * ## This Drop Nulls Overload
+ * ### This Drop Nulls Overload
  */
 private interface CommonDropNullsFunctionDoc
 
@@ -352,7 +352,7 @@ private interface SetDropNAOperationArg
 
 /**
  * @include [DropNA] {@comment Description of the dropNA operation.}
- * ## This Drop NA Overload
+ * ### This Drop NA Overload
  */
 private interface CommonDropNAFunctionDoc
 
@@ -448,7 +448,7 @@ private interface SetDropNaNsOperationArg
 
 /**
  * @include [DropNaNs] {@comment Description of the dropNaNs operation.}
- * ## This Drop NaNs Overload
+ * ### This Drop NaNs Overload
  */
 private interface CommonDropNaNsFunctionDoc
 

core/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/Nulls.kt

@@ -2,78 +2,73 @@ package org.jetbrains.kotlinx.dataframe.documentation
 
 internal interface DocumentationUrls {
 
-    interface NameArg
-
-    /** See {@getArg [NameArg]} on the documentation website. */
-    interface Text
-
     /** https://kotlin.github.io/dataframe */
     interface Url
 
     interface DataRow {
 
-        /** [{@include [Text]}{@setArg [NameArg] Row Expressions}]({@include [Url]}/datarow.html#row-expressions) */
+        /** [See Row Expressions on the documentation website.]({@include [Url]}/datarow.html#row-expressions) */
         interface RowExpressions
 
-        /** [{@include [Text]}{@setArg [NameArg] Row Conditions}]({@include [Url]}/datarow.html#row-conditions) */
+        /** [See Row Conditions on the documentation website.]({@include [Url]}/datarow.html#row-conditions) */
         interface RowConditions
     }
 
-    /** [{@include [Text]}{@setArg [NameArg] `NaN` and `NA`}]({@include [Url]}/nanAndNa.html) */
+    /** [See `NaN` and `NA` on the documentation website.]({@include [Url]}/nanAndNa.html) */
     interface NanAndNa {
 
-        /** [{@include [Text]}{@setArg [NameArg] `NaN`}]({@include [Url]}/nanAndNa.html#nan) */
+        /** [See `NaN` on the documentation website.]({@include [Url]}/nanAndNa.html#nan) */
         interface NaN
 
-        /** [{@include [Text]}{@setArg [NameArg] `NA`}]({@include [Url]}/nanAndNa.html#na) */
+        /** [See `NA` on the documentation website.]({@include [Url]}/nanAndNa.html#na) */
         interface NA
     }
 
-    /** [{@include [Text]}{@setArg [NameArg] `update`}]({@include [Url]}/update.html) */
+    /** [See `update` on the documentation website.]({@include [Url]}/update.html) */
     interface Update
 
-    /** [{@include [Text]}{@setArg [NameArg] `fill`}]({@include [Url]}/fill.html) */
+    /** [See `fill` on the documentation website.]({@include [Url]}/fill.html) */
     interface Fill {
 
-        /** [{@include [Text]}{@setArg [NameArg] `fillNulls`}]({@include [Url]}/fill.html#fillnulls) */
+        /** [See `fillNulls` on the documentation website.]({@include [Url]}/fill.html#fillnulls) */
         interface FillNulls
 
-        /** [{@include [Text]}{@setArg [NameArg] `fillNaNs`}]({@include [Url]}/fill.html#fillnans) */
+        /** [See `fillNaNs` on the documentation website.]({@include [Url]}/fill.html#fillnans) */
         interface FillNaNs
 
-        /** [{@include [Text]}{@setArg [NameArg] `fillNA`}]({@include [Url]}/fill.html#fillna) */
+        /** [See `fillNA` on the documentation website.]({@include [Url]}/fill.html#fillna) */
         interface FillNA
     }
 
-    /** [{@include [Text]}{@setArg [NameArg] `drop`}]({@include [Url]}/drop.html) */
+    /** [See `drop` on the documentation website.]({@include [Url]}/drop.html) */
     interface Drop {
 
-        /** [{@include [Text]}{@setArg [NameArg] `dropNulls`}]({@include [Url]}/drop.html#dropnulls) */
+        /** [See `dropNulls` on the documentation website.]({@include [Url]}/drop.html#dropnulls) */
         interface DropNulls
 
-        /** [{@include [Text]}{@setArg [NameArg] `dropNaNs`}]({@include [Url]}/drop.html#dropnans) */
+        /** [See `dropNaNs` on the documentation website.]({@include [Url]}/drop.html#dropnans) */
         interface DropNaNs
 
-        /** [{@include [Text]}{@setArg [NameArg] `dropNA`}]({@include [Url]}/drop.html#dropna) */
+        /** [See `dropNA` on the documentation website.]({@include [Url]}/drop.html#dropna) */
         interface DropNA
     }
 
-    /** [{@include [Text]}{@setArg [NameArg] Access APIs}]({@include [Url]}/apilevels.html) */
+    /** [See Access APIs on the documentation website.]({@include [Url]}/apilevels.html) */
     interface AccessApis {
 
-        /** [{@include [Text]}{@setArg [NameArg] String API}]({@include [Url]}/stringapi.html) */
+        /** [See String API on the documentation website.]({@include [Url]}/stringapi.html) */
         interface StringApi
 
-        /** [{@include [Text]}{@setArg [NameArg] Column Accessors API}]({@include [Url]}/columnaccessorsapi.html) */
+        /** [See Column Accessors API on the documentation website.]({@include [Url]}/columnaccessorsapi.html) */
         interface ColumnAccessorsApi
 
-        /** [{@include [Text]}{@setArg [NameArg] KProperties API}]({@include [Url]}/kpropertiesapi.html) */
+        /** [See KProperties API on the documentation website.]({@include [Url]}/kpropertiesapi.html) */
         interface KPropertiesApi
 
-        /** [{@include [Text]}{@setArg [NameArg] Extension Properties API}]({@include [Url]}/extensionpropertiesapi.html) */
+        /** [See Extension Properties API on the documentation website.]({@include [Url]}/extensionpropertiesapi.html) */
         interface ExtensionPropertiesApi
     }
 
-    /** [{@include [Text]}{@setArg [NameArg] Column Selectors}]({@include [Url]}/columnselectors.html) */
+    /** [See Column Selectors on the documentation website.]({@include [Url]}/columnselectors.html) */
     interface ColumnSelectors
 }

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

@@ -59,7 +59,7 @@ internal interface SelectingColumns {
      * Select or express columns using the {@include [ColumnsSelectionDslLink]}.
      * (Any (combination of) {@include [AccessApiLink]}).
      *
-     * This DSL comes in the form a [Columns Selector][ColumnsSelector] lambda,
+     * This DSL is initiated by a [Columns Selector][ColumnsSelector] lambda,
      * which operates on the {@include [ColumnsSelectionDslLink]} and
      * expects you to return a [ColumnsResolver]; an entity formed by calling any (combination) of the functions
      * in the DSL that is or can be resolved into one or more columns.
@@ -92,7 +92,7 @@ internal interface SelectingColumns {
      * Select or express a single column using the Column Selection DSL.
      * (Any {@include [AccessApiLink]}).
      *
-     * This DSL comes in the form of a [Column Selector][ColumnSelector] lambda,
+     * This DSL is initiated by a [Column Selector][ColumnSelector] lambda,
      * which operates in the {@include [ColumnSelectionDslLink]} and
      * expects you to return a [SingleColumn].
      *