Skip to content

Add KDocs for DataRowSchemaApi #2000

Description

@zaleslaw

Add KDocs for DataRowSchemaApi

The file core/src/main/kotlin/org/jetbrains/kotlinx/dataframe/api/DataRowSchemaApi.kt has no KDocs. Add concise KDocs for its three public declarations.

Scope

  • DataRowSchema — the marker interface a user's data class implements to be usable as a typed row schema.
  • dataFrameOf(vararg rows: T) — builds a DataFrame<T> from row objects of a DataRowSchema type.
  • DataFrame<T>.append(vararg rows: T) — returns a new DataFrame<T> with the given schema rows appended.

KDocs should explain

  • DataRowSchema: what implementing it enables (strongly-typed dataFrameOf / append), and that rows are converted via toDataFrame() reflection.
  • dataFrameOf: each row object becomes one row; columns are derived from the schema's properties.
  • append: it does not mutate — it returns a new frame (source + appended rows concatenated).

Acceptance criteria

  • All three declarations have concise KDocs.
  • The KDocs note that append returns a new DataFrame (no in-place mutation) and that rows map to columns by the schema's properties.

Metadata

Metadata

Assignees

Labels

KDocsImprovements or additions to KDocs

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions