Add Info about artifacts to Migration Guide
Nobody has claimed this yet.
- Dominant language
- Kotlin
- Stars
- 1.1k
- Forks
- 83
- Avg merge
- 4d 12h
- Merged PRs (30d)
- 30
Description
Describe all changes in our artifacts.
Refer to https://kotlin.github.io/dataframe/modules.html
Add an "Artifacts / Modules" section to the 1.0 Migration Guide (clarifies #1779)
Motivation
Between 0.15 and 1.0 the set of published Maven artifacts changed significantly (functionality was split into new modules, some modules were added, the general dataframe artifact's composition changed, and the plugins story changed). Users upgrading from 0.15 currently have to piece this together from the Modules page and scattered mentions in the guide. The Migration Guide should have one dedicated section that lists exactly what changed at the artifact/dependency level, so upgrading users know which dependencies to add, remove, or rename.
This is the concrete, scoped version of #1779 ("Describe all changes in our artifacts"), which is currently in Needs_clarification.
Where it goes
docs/StardustDocs/topics/MigrationTo_1_0.md already has a commented-out placeholder for this (tied to #1630):
<!--TODO (https://github.com/Kotlin/dataframe/issues/1630)
## Modules
## Compiler Plugin
## Changes in working with JDBC
-->
The new section should replace/flesh out the ## Modules part of that placeholder. Coordinate with #1630 so the two don't diverge.
Scope — artifact changes to document (0.15 → 1.0)
Describe, as a 0.15 → 1.0 table plus short notes, at least:
- New
dataframe-csvmodule — CSV/TSV IO moved out of core into its own module (Deephaven-based); included by default in the generaldataframeartifact and in%use dataframe. (Cross-link the existing "Migration to Deephaven CSV" section.) dataframe-jsonas a standalone module — and the fact that it is pulled in transitively bydataframe-csv/dataframe-excel(with the documentedexcludeescape hatch).- OpenAPI split —
dataframe-openapi(runtime, add to use generated schemas) vs the newdataframe-openapi-generator(generation, used by Gradle/KSP/Jupyter). - New experimental
dataframe-geomodule (requires the OSGeo repository). - General
dataframeartifact composition — now = all core + IO modules, excluding experimental ones; state what moved in/out vs 0.15. - Plugins changes — the new official Kotlin compiler plugin
kotlin.plugin.dataframe; the Gradle pluginkotlinx.dataframeand KSPsymbol-processor-allbeing under consideration for deprecation, with data-schema generation now via dedicated methods. - Coordinates / naming — confirm any artifact
groupId/artifactIdrenames or coordinate changes since 0.15 (see open questions).
For each: what the user must change in their build file (add/remove/rename dependency).
Open questions (the "needs clarification" part)
- Baseline: is the guide strictly
0.15 → 1.0, or should it also mention intermediate1.0-Betaartifact changes? - Were any artifacts renamed or removed (not just added/split) since 0.15? If so, list old→new coordinates explicitly.
- Should the compiler-plugin / Gradle-plugin / JDBC details live here or in the sibling
## Compiler Plugin/## Changes in working with JDBCplaceholder sections (to avoid duplication with #1630)? - Minimum Kotlin/Gradle version bumps that affect artifact usage — in scope here or elsewhere?
Acceptance criteria
MigrationTo_1_0.mdhas a dedicated Modules / Artifacts section (replacing the commented-out## Modulesplaceholder).- It lists every artifact-level change (added / split / moved / deprecated) with a
0.15 → 1.0mapping and the required build-file change. - It cross-links the Modules page and the existing CSV/Deephaven migration section rather than duplicating them.
- The open questions above are resolved (or explicitly deferred) before the section is written.
- Alignment with #1630 is confirmed so the Modules / Compiler Plugin / JDBC sections don't overlap.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with docs/StardustDocs/topics/MigrationTo_1_0.md and the Modules page, then review the existing CSV/Deephaven migration section and issue #1630. Resolve the listed artifact, coordinate, version-scope, and section-boundary questions before documenting the 0.15 → 1.0 dependency changes. Done means a dedicated Modules / Artifacts section with the mapping, required build-file changes, cross-links, and no overlap with #1630.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- kotlin
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100