bincode icon indicating copy to clipboard operation
bincode copied to clipboard

Document v1/v2 split and motivation for moving away from serde

Open mwcampbell opened this issue 4 years ago • 4 comments

As a newcomer to this project, I was confused at first, because the README only barely mentioned the split between v1 and v2. Also, as far as I can tell, the motivation for moving away from serde in v2 isn't documented. I'm curious about the motivation because serde is a critical part of the Rust ecosystem, and I'm afraid that requiring structs to implement or derive bincode-specific traits will be a step backward for bincode, but I'm sure there's a good reason.

mwcampbell avatar Apr 30 '22 14:04 mwcampbell

note that you can still add the "serde" feature in v2

BarbossHack avatar May 04 '22 22:05 BarbossHack

We have a list of known issues with serde on docs.rs. There are some other reasons we wanted to make the serde dependency optional (supporting embedded targets, reducing dependencies, increasing performance). We can add a FAQ to the repo with these reasons.

VictorKoenders avatar May 05 '22 07:05 VictorKoenders

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

stale[bot] avatar Aug 14 '22 22:08 stale[bot]

I'd love to see a little write-up into the decision-making process beyond solving for the "known issues" with serve in the docs.

This would help me for two reasons:

  1. Help me decide whether bincode's goals as an encoding format are aligned with what I need it for
  2. Help me re-evaluate some of my own decisions around the use of serde

It wouldn't need to be perfect nor even accurately reflect the discussions that took place, but it there's something that can help with the above (namely 2, I think most of your other documentation covers 1, but it would still give me some insight), that would be appreciated.

richardpringle avatar Dec 13 '23 16:12 richardpringle