Seeking help

[aesopwolf]

This project is looking for new maintainers. You can show your interest by opening a PR that fixes something. To begin with I'll add pretty much anyone that opens a PR as a member, giving them the ability to merge their own PR (please be responsible). I'll also give you access to publish it to npm (again, please be responsible).

The community has shown a lot of interest in this project and when I first got involved I had good intentions to bring it back to life, but I haven't given this the time and love it deserves. So, hopefully, by converting this to a github org it will finally get the attention it needs.

[MilosRasic]

@aesopwolf My team, working on Gogo's B2B portal, has ran into formsy's lack of maintenance as a block on the road to React 16. We'd very much like to help with maintaining the project and getting it up to date, but due to the state of the repo I'd say some consensus is needed on how to proceed so that we don't end up doing work that is going to be rejected or reverted at a later date. Here's my rough idea:

1. Create a "mixins" branch from master to retain mixin support for anyone who may possibly still need it.
2. Merge beta into master
3. Update master to work with both React 15 and 16 and move React and ReactDOM to peerDependencies
4. profit??

Please let me know if this sounds ok or if you have a better idea and we'll get someone to work on it.

[apuntovanini]

@MilosRasic that sounds a good timeline, just a thought on the first point: since mixins are deprecated anyways, do we really need it? Completely agree from 2nd onwards 👍 , been using beta for weeks and works perfectly (not in react 16)

[MilosRasic]

@apuntovanini I don't know about the mixins branch. Does it hurt to have it? Why is there a react 14 branch for that matter? I'd keep them more because that seems to be how it was done before than for any other reason.

[apuntovanini]

Nope, it definitely doesn't hurt 😄 was just a thought, in case you need a help, happy to lend a hand or two

[rkuykendall]

Aside from getting good code that's already been written into the main branch and released ( Things like the 1.0 branch, the -2 fork, etc. ) I think we should prioritize the most popular non-api-breaking changes: https://github.com/christianalfoni/formsy-react/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc

1. Deprecation of React.createClass
2. Deprecation of React.PropTypes
3. Support React v16.0

Many of these have already been fixed several times in several branches/PRs so I think the hard part will be knowing what to merge.

[rkuykendall]

This removed two branches that were over two years old, validation-errors-improvement and react-0.14. They are still in the original repo and I can bring them back if anyone objects. I also created a PR for the beta branch. @MilosRasic @apuntovanini it sounds like you both agree getting that branch merge-ready should be first priority?

[MilosRasic]

Absolutely. Time permitting, I'll try to get a React 16 fork working and test it in our thing that makes a pretty heavy use of formsy. If it works there it should work anywhere.

It would be nice if we could also get the readme straight. For example, in 1.0.0, withFormsy is exported as Wrapper.

[rkuykendall]

Trying to gather that information on PR, let me know if you have anything else: #3

I'll be getting more familiar with the 1.0 branch today, seeing what the upgrade process is in our own app ( also very heavy use of Formsy ).

[aesopwolf]

@MilosRasic that sounds like a great plan, and I agree with @apuntovanini that mixins aren't really needed. They could (should?) be left out for the 1.0 release. I'll add you to this repo and you can setup a roadmap using the gihub project feature. It would be nice to have an outline / roadmap that anyone is free to start picking up issues and opening PR's.

[rkuykendall]

After the most recent value prop-type PR was merged, everything seems to be working well on my upgrade branch. Does anyone have any testing they can do on their codebases, or additional must-have features for the first release?

The react 16 PR #11 is our only open PR as-is. I'm having trouble getting it running locally but I think that's my fault.

[MilosRasic]

I'll test on my work project after the weekend.

I'm thinking about publishing 1.0.1 as latest release as a React 15 release without React.PropTypes and create-class, then doing a 1.1.0 release at a later date that supports React 16.

Any issues or objections?

[apuntovanini]

@rkuykendall which issues are you facing? May I help you? @MilosRasic good idea about the releases. If you guys agree I think we should get a proper CHANGELOG.md running. I can take care of it, how about conventional-commits (https://conventionalcommits.org/)

[rkuykendall]

publishing 1.0.1 as latest release

And skipping 1.0.0? I think that the 1.0.0 version number properly communicates the upgrade-if-brave nature of such a significant code change.

I agree with getting a release out ASAP, since PropTypes and create class are older issues than 16 support. Though 16 support should be our next release goal.

which issues are you facing? May I help you?

My local was saying react-formsy didn't have react. I don't think it was your code, I think I may have just missed a step or I've done yarn build and yarn add file:./react-formsy too many times or something. How have you been setting up your dev react-formsy with your app?

Proper changelog additions would be great. There are some good notes in the 1.0 beta commit messages, some of which I copied to the 1.0 PR. We should make sure the breaking API changes and upgrade path are clear.