Skip to content
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

The road to 4.0 #1494

Closed
leidegre opened this issue Mar 19, 2018 · 38 comments
Closed

The road to 4.0 #1494

leidegre opened this issue Mar 19, 2018 · 38 comments

Comments

@leidegre
Copy link
Contributor

So, not much has been happening since October, yet a lot of breaking changes have gone into the 4.x branch, some of these with respect to improved Records, like better typing and performance.

I get that people are crazy busy but I really think we should try and get a 4.0 release done. How can we help?

@kvanbere
Copy link

It would be great to merge #1464 before 4.0

@vytautas-pranskunas-
Copy link

4.0 is totally MUST

@leidegre
Copy link
Contributor Author

@leebyron is aware https://twitter.com/leeb/status/976862384794095616 I'm confident it will happen but we'll have to hang tight for a while.

@joshvito
Copy link

+1 to wishing and hoping for a release date for v.4.0

@kvanbere
Copy link

Flow typings are still mostly completely broken though, 4.0 can not release in this state :(

We have been using the rc for 2 months and have about 50 // $FlowFixMes accumulated in our code.

@acusti acusti mentioned this issue May 2, 2018
@acusti
Copy link
Contributor

acusti commented May 3, 2018

@donkeybonks Here’s hoping that many of your issues will be resolved by #1464. We’ve also been using rc.9 for a few months in production, and while we’ve run into some annoying type bugs that required adding $FlowFixMes, the significant improvement in type coverage and detail has felt very much worth it.

@leebyron Looking through the GitHub issues, I found 6 remaining non-type-definition and non-documentation related issues for the v4.0 RCs in approximate order of importance:

There are also a couple issues related to improving support for Record sub-typing, which might be candidates for a follow-on release:

The rest of the issues have to do with types or with documentation, and at least for the type definition issues, seems like a good portion of them could be resolved by #1464.

Type definition issues:

Documentation issues:

Those are all the relevant issues I found looking at the first 4 pages of issues in GitHub pertaining to the 4.0 release.

@leebyron On a related note, there are a huge number of us relying heavily on Immutable.js in our work who would be very happy to contribute to the project. If nothing else, you can most likely find knowledgable and passionate people willing to help manage issues and assist with documentation, as well as look into implementing useful workflow improvements like stale issue bots and the like. I know managing open source is really challenging and complex, particularly when you are already so involved in a much higher visibility project like graphql. But Immutable.js, though lower profile, is a very widely used workhorse that has become an essential tool for a lot of the modern functional-ish JS dev community, and I think you will be able to find useful help from that community.

@leidegre
Copy link
Contributor Author

leidegre commented May 4, 2018

@acusti should we just fork the repo and finish the 4.0 release, if everything goes well I think @leebyron would just merge everything back into an offical 4.0 release?

@acusti
Copy link
Contributor

acusti commented May 4, 2018

@leidegre I think that could be useful. At least knock out some of the most important bugs and see if we can fix some types.

Then we can also publish builds as we go so others can just swap out their dependency string for "immutable" in package.json and we can get feedback from those who have posted issues on whether they are resolved. In other cases where I’ve had to use a fork, in order to avoid the overhead of npm publishing, I’ve also created a <repo name>-build repo that just has the built files. I then refer to that repo directly along with the short commit hash in the package.json, i.e. "react-dom": "github:brandcast/react-dom-built#e673e48"

@leidegre
Copy link
Contributor Author

leidegre commented May 6, 2018

@acusti can you manage this? I can commit about 1-2 hours on a weekly basis, no problem but that's about it.

@acusti
Copy link
Contributor

acusti commented May 10, 2018

@leidegre I created a fork at brandcast/immutable-js, and am pushing up built versions of immutable with bug fixes to brandcast/immutable-js-built.

So far, I’ve fixed #1438 and #1490, and I merged #1464, which I’m hoping will help with flow issues mentioned by @donkeybonks and others. To try out the fixes, replace your immutable dependency string in package.json with:

    "immutable": "brandcast/immutable-js-built#aa94985",

Note that I needed to clear out my yarn.lock file and node_modules and install from scratch to get the proper version.

@petrbrzek
Copy link

@leebyron left facebook. So I would not expect v4 anytime soon. 😞

@leebyron
Copy link
Collaborator

Hey all - @robinhood is also a big user of Immutable.js and I still plan on releasing Immutable v4.

I'll be working on the next release candidate this week to establish remaining issues

@leebyron
Copy link
Collaborator

@acusti can you make sure any issues you've fixed on your fork are reflected in pull requests in this repo? You can mention them here as well to ensure they get the correct focus.

Thanks so much for building up a list of issues

@acusti
Copy link
Contributor

acusti commented May 15, 2018

@leebyron Congrats on the change! That sounds exciting.

I made PRs for the fixes. The only thing that made it into the fork so far are the following PRs:

@leebyron
Copy link
Collaborator

Thanks! I've merged all three of those PRs and will keep working on the next release

@leebyron
Copy link
Collaborator

I also just added all the issues you tracked into the v4.0 milestone https://github.com/facebook/immutable-js/milestone/1

@Brantron
Copy link

@leebyron 3 more PRs open for 4.0

#1549
#1544
#1543

@bryanrideshark
Copy link

Is there any way a non-involved person like myself could help getting this released? Our team would like to transition to ImmutableJS but the problems with typing in 3.x are preventing us from making the leap.

I'd be very willing to work on low-hanging fruit if it can help get 4.x out the door.

@polgfred
Copy link

Same here. Things seem to have stalled, and I'd love to help.

@Brantron
Copy link

I would also love to lend a hand. I think a lot of folks would love to start using 4.x

@glenjamin
Copy link
Contributor

glenjamin commented Jul 21, 2018

Is there a milestone for what is blocking a 4.0 release? Presumably anything that's not breaking can wait until after a 4.0 is cut and go into a follow-up minor or patch release.

Edit: duh - I didn't actually read the issue very well, milestone is here: https://github.com/facebook/immutable-js/milestone/1

@lukaswelinder
Copy link

lukaswelinder commented Aug 15, 2018

What's the status on reaching 4.0? It's been nearly a year since @leebyron posted the following

Closing this issue since the next release is coming imminently.

Looking at the 4.0 milestone; the last PR to be merged was well over a year ago; the most recently closed issue was a discussion about breaking changes which was close several months ago. I am concerned by this lack of engagement and transparency of precess.

It's clear that the community wants to see this happen and is willing to put in the time and effort to get there, so it would be nice to see those aspirations and efforts come to fruition.

@inakianduaga
Copy link

It's clear there is currently no official maintainer. Which for a project backed by Facebook is a bit shocking. We are currently using immutableJS in one of our projects but I would definitely not recommend it for starting something new.

@erkez
Copy link

erkez commented Aug 27, 2018

ImmutableJS is a great library, but you are right, there are probably no maintainers at the moment. It seems like Lee Byron has moved to another company, and by looking at the repo statistics, he was pretty much the only maintainer.

I've been using version 4 quite extensively in my projects for a very long time and haven't noticed any problems, though it would be nice to see it moving out of alpha.

@Brantron
Copy link

@sophiebits can a new maintainer be selected so the community can keep this project going? We love using it and have put in a fair amount of work to try to get v4 out of RC.

@majelbstoat
Copy link

Alternatively, would facebook consider allowing this to move to its own organisation? Something like: https://github.com/immutable-js/immutable-js? I know the license means it could just be forked unilaterally by the community, but npm naming would be an issue, and it would be great to avoid fragmentation if possible (and reading the comments, I believe @leebyron would prefer to avoid that fragmentation too).

@conartist6
Copy link
Contributor

conartist6 commented Sep 8, 2018

I'm not certain I have enough time, but I could be a potential maintainer. I don't have a track record of contributions here but I'm currently working on developing Sequins, which is an implementation of Immutable's API for mutable data structures. My project's success hinges on the continued popularity (and maintenance) of Immutable.

@dieseldeesh
Copy link

dieseldeesh commented Dec 4, 2018

@leebyron Thanks for cutting rc-12. As we eagerly await 4.x, would it be possible for you to add assignees (which may be yourself) and due dates for the remaining issues that are blocking the major version release?

Several ICs have offered a helping hand in seeing this over the line. Would it be possible to crowdsource the effort to get 4.x stable release (with you being the ultimate reviewer of course).

@acusti
Copy link
Contributor

acusti commented Sep 16, 2019

@leebyron you mentioned working on a plan for the future of immutable.js development in #1689 (comment) back in february. is there any way any of us can help even just with fleshing out that plan for the future?

immutable.js v4 includes enough major improvements that it is a shame that consumers who npm / yarn install immutable to get the latest version won’t get those improvements. i think just getting a 4.0 out the door with the stable tag would be a tremendously valuable accomplishment for the community at large.

i did some more issue triage on new issues in the last year, and found:

there’s also an ie11 bug that i wasn’t able to confirm (no ie11 access), #1711, but i’m not sure what the required browser compatibility is for immutable 4.

the 4.0 milestone currently includes

in my opinion, the only one of those issues that really needs to be fixed before a 4.0 stable release is #1701. it would nice to fix #1715 and #1475 also, but i don’t think it would be worth holding up a stable release for them.

@conartist6
Copy link
Contributor

Also given that it's a breaking change, I'd like to beg that long overdue support for Imm.Map(new window.Map(...data)) be added.

@binarykitchen
Copy link

Is there an overview of all breaking changes and migration guides from v3 to v4? Would help us developers greatly to adjust code when upgrading.

@JustFly1984
Copy link

This library is clearly dead, @leebyron has changed job, and not interested in working on this project anymore. BTW does Facebook owns a license on Immutable.js?

@leebyron
Copy link
Collaborator

leebyron commented Oct 30, 2019 via email

@acusti
Copy link
Contributor

acusti commented Mar 19, 2020

@leebyron i was excited to see PRs getting merged in january (#1676). any chance of an update on the plan toward 4.0 and stable maintenance?

@acusti
Copy link
Contributor

acusti commented Mar 24, 2020

re: my above question: #1689 (comment)

also: https://twitter.com/leeb/status/1242485118536527873

@pbadenski
Copy link

Any updates?

@acusti
Copy link
Contributor

acusti commented Aug 11, 2020

@pbadenski i would suggest following #1689 for the latest. the conversation has mostly migrated there. that said, the update is that there is no update; we’re still waiting for something to be figured out for future maintenance of the project.

@jdeniau
Copy link
Member

jdeniau commented Jul 9, 2021

I'm closing this as there is now a milestone for 4.0.
A new rc has also been publish : https://github.com/immutable-js/immutable-js/releases

@jdeniau jdeniau closed this as completed Jul 9, 2021
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

No branches or pull requests