-
Notifications
You must be signed in to change notification settings - Fork 653
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
base: doc-restructuring-master
Are you sure you want to change the base?
update: first update for serialization documentation restructuring #2978
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.
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
)
docs/topics/serialization.md
Outdated
|
||
## Kotlin serialization libraries | ||
|
||
The `kotlinx.serialization` library offers support for all platforms, including JVM, JavaScript, Native. |
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.
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).
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.
I added some further comments. It may be that some of them are better used in other pages (not in this request)
4e69cdf
to
85abee7
Compare
This PR is for the first batch of documentation updates for KT-79623 [Docs][Libraries] Serialization introduction