Skip to content

update: first update for serialization documentation restructuring #2978

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

Open
wants to merge 5 commits into
base: doc-restructuring-master
Choose a base branch
from

Conversation

daniCsorbaJB
Copy link

@daniCsorbaJB daniCsorbaJB commented Apr 10, 2025

This PR is for the first batch of documentation updates for KT-79623 [Docs][Libraries] Serialization introduction

Copy link
Contributor

@pdvrieze pdvrieze left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You want to be accurate in how serialization works. The "intermediate data" representation is misleading, an intermediate format is fundamentally impossible (even without supporting format specific escape hatches such as JsonPolymorphicSerializer)


## Kotlin serialization libraries

The `kotlinx.serialization` library offers support for all platforms, including JVM, JavaScript, Native.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It may be worthwhile to clarify more that the serialization library provides the format agnostic infrastructure. Then the -json and -cbor libraries are format implementations (they are fundamentally different and are independent even though first-party).

Copy link
Contributor

@pdvrieze pdvrieze left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added some further comments. It may be that some of them are better used in other pages (not in this request)

@daniCsorbaJB daniCsorbaJB changed the base branch from master to doc-restructuring-master July 31, 2025 13:56
@daniCsorbaJB daniCsorbaJB force-pushed the doc-restructuring-updates-1 branch from 4e69cdf to 85abee7 Compare August 1, 2025 06:07
@daniCsorbaJB daniCsorbaJB marked this pull request as ready for review August 1, 2025 07:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants