matthewmueller / next-cookies

Tiny little function for getting cookies on both client & server with next.js.
368 stars 17 forks source link

Changelog #27

Open Vadorequest opened 4 years ago

Vadorequest commented 4 years ago

Is it possible to have a CHANGELOG.md file?

I'm using 1.1.3 and I see you've released 2.0.3 recently, but no changelog and no way to quickly now what has changed, nor what are the breaking changes.

nfriedly commented 4 years ago

Hi @Vadorequest,

I'm not sure if we'll add a changelog, but I can tell you that the major change for v2 was switching the underlying library to universal-cookie. V1.x used two libraries, cookie and component-cookie, which worked most if the time but caused issues for a few people.

The patch releases since v2 have been minor things like fixing typescript definitions and ensuring the library is pure ES5 for easy bundling.

In general, I recommend upgrading, but if v1 is working for you, then there's no pressure.

Vadorequest commented 4 years ago

Thank you @nfriedly for the quick feedback.

It's funny because I also tried to replace 2 libs with universal-cookie, but it didn't work with SSR using Next.js. See https://github.com/reactivestack/cookies/issues/256

I strongly recommend having a changelog, it's a sign of good package's health and transparency. You can limit yourself to major versions for starter 😄