-
Notifications
You must be signed in to change notification settings - Fork 75
Add "Migrating from Pandas" guide #1328
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull Request Overview
This PR adds a migration guide for Pandas users moving to Kotlin DataFrame and tidies up navigation and formatting.
- Introduces a new “Migrating from Pandas” guide
- Cleans up a formatting quirk in the Quickstart guide
- Updates the documentation tree to include the new guide
Reviewed Changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
File | Description |
---|---|
docs/StardustDocs/topics/guides/quickstart.md | Merged two bullet lines into a single paragraph and added spacing |
docs/StardustDocs/topics/guides/migratingFromPandas.md | Added the full migration guide from Pandas to Kotlin DataFrame |
docs/StardustDocs/d.tree | Inserted the new guide into the site’s table of contents |
Comments suppressed due to low confidence (2)
docs/StardustDocs/topics/guides/migratingFromPandas.md:214
- [nitpick] Wrap technical terms and function names such as
advanced time indexing
andresample()
in backticks for inline code formatting to improve readability.
- Some Pandas features (like advanced time indexing, resample()) aren’t available yet.
docs/StardustDocs/topics/guides/migratingFromPandas.md:1
- [nitpick] Consider renaming the file to use kebab-case (e.g.,
migrating-from-pandas.md
) to match the naming convention of other guide files.
# Migration Guide: Pandas to Kotlin DataFrame
@@ -16,8 +16,8 @@ This guide shows how to quickly get started with **Kotlin DataFrame**: | |||
you'll learn how to load data, perform basic transformations, and build a simple plot using Kandy. | |||
|
|||
We recommend [starting with **Kotlin Notebook**](gettingStartedKotlinNotebook.md) for the best beginner experience — | |||
everything works out of the box, | |||
including interactivity and rich DataFrame and plots rendering. | |||
everything works out of the box, including interactivity and rich DataFrame and plots rendering. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remove the trailing whitespace at the end of this line to avoid unintended formatting or layout issues.
everything works out of the box, including interactivity and rich DataFrame and plots rendering. | |
everything works out of the box, including interactivity and rich DataFrame and plots rendering. |
Copilot uses AI. Check for mistakes.
@zaleslaw may be use tabs instead of subsequent paragraphs (like polars docs do)? Instead of ### Pandas (Matplotlib)
```python
df["profit"] = df.revenue - df.cost
pivot = df.pivot_table(values="profit", index="product", columns="year")
```
### Kotlin DataFrame (Kandy)
```kotlin
val pivot = df
.add("profit") { revenue - cost }
.pivot(product, year) { mean(profit) }
``` add tabs: <tabs>
<tab title="Pandas (Matplotlib)">
```python
df["profit"] = df.revenue - df.cost
pivot = df.pivot_table(values="profit", index="product", columns="year")
```
</tab>
<tab title="Kotlin DataFrame (Kandy)">
```kotlin
val pivot = df
.add("profit") { revenue - cost }
.pivot(product, year) { mean(profit) }
```
</tab>
</tabs> in all such places. |
It's a draft, should be shipped with the validated Pandas / Kotlin DataFrame code