Okay to do a 3.0.1 release of core with documentation fixes?

261 views
Skip to first unread message

Janis Voigtländer

unread,
Jan 19, 2016, 2:23:24 AM1/19/16
to elm...@googlegroups.com

Since the release of core-3.0.0, some documentation fixes have accumulated, but are not visible on the package site. Some of these improvements could forestall questions that are coming up on the elm-discuss list. (Also, I have a bunch of students who are doing their term projects using Elm right now, so are looking at this documentation every day.)

It would be nice to release the documentation fixes to the package site. It would be strictly a PATCH release (elm-package diff is saying so), in fact there are only changes to the documentation, nothing changed in code. So no possible regressions.

Since I have write access to the repository, I could tag and publish a 3.0.1, but obviously I don’t want to do that without consent. Evan?

As a summary, the changes that would differentiate 3.0.1 from 3.0.0 can be seen in this GitHub view:

https://github.com/elm-lang/core/compare/3.0.0...master

Let me add that I would be more thrilled to have an actual bugfix release (which would still be 3.0.1, since only PATCH changes involved), including as many as possible of the following pull requests:

https://github.com/elm-lang/core/pull/183
https://github.com/elm-lang/core/pull/222
https://github.com/elm-lang/core/pull/294
https://github.com/elm-lang/core/pull/442
https://github.com/elm-lang/core/pull/463

But I don’t have my hopes high on that.

Daniel Bachler

unread,
Jan 19, 2016, 3:18:51 AM1/19/16
to elm-dev
Yes please, for both the doc fixes and the bugfixes.

I really like elm but the average time it takes for bugfix PRs to get merged is not great. IMHO this is bad both because people will be bitten by these bugs even though a solution already exists in the form of a PR and also because it discourages contributors.

There are also some PRs that suggest temporary solutions to existing problems, like e.g. https://github.com/elm-lang/core/pull/286 . I appreciate that the spirit of Elm is to prefer well thought out solutions over quick fixes, but it seems to me that there are several cases where opportunities to make the edges of Elm a little less sharp are disregarded in favour of some future general improvement. Maybe there can be a mechanism where temporary improvements can be linked back to big improvement tickets so they can be reverted if necessary once those features are implemented?

Max Goldstein

unread,
Jan 19, 2016, 9:54:19 AM1/19/16
to elm-dev
I also support a docsfix/bugfix release. Part of the motivation of making core "just another package" is that these sorts of changes could be made without blocking on major language improvements or requiring everyone to download a new compiler.

Janis Voigtländer

unread,
Jan 21, 2016, 1:41:24 AM1/21/16
to elm...@googlegroups.com

Let me add that I would be more thrilled to have an actual bugfix release (which would still be 3.0.1, since only PATCH changes involved), including as many as possible of the following pull requests:

https://github.com/elm-lang/core/pull/183
https://github.com/elm-lang/core/pull/222
https://github.com/elm-lang/core/pull/294
https://github.com/elm-lang/core/pull/442
https://github.com/elm-lang/core/pull/463

Janis Voigtländer

unread,
Jan 24, 2016, 4:46:47 AM1/24/16
to elm...@googlegroups.com

Let me add that I would be more thrilled to have an actual bugfix release (which would still be 3.0.1, since only PATCH changes involved), including as many as possible of the following pull requests:

https://github.com/elm-lang/core/pull/183
https://github.com/elm-lang/core/pull/222
https://github.com/elm-lang/core/pull/294
https://github.com/elm-lang/core/pull/442
https://github.com/elm-lang/core/pull/463

Adding https://github.com/elm-lang/core/pull/342 to that list.

And https://github.com/elm-lang/core/pull/491, since the issue that addresses seems to prevent a person from using Elm in production right now.

Janis Voigtländer

unread,
Jan 30, 2016, 12:58:44 AM1/30/16
to elm...@googlegroups.com

Let me add that I would be more thrilled to have an actual bugfix release (which would still be 3.0.1, since only PATCH changes involved), including as many as possible of the following pull requests:

https://github.com/elm-lang/core/pull/183
https://github.com/elm-lang/core/pull/222
https://github.com/elm-lang/core/pull/294
https://github.com/elm-lang/core/pull/442
https://github.com/elm-lang/core/pull/463

Adding https://github.com/elm-lang/core/pull/342 to that list.

And https://github.com/elm-lang/core/pull/491, since the issue that addresses seems to prevent a person from using Elm in production right now.


Reply all
Reply to author
Forward
0 new messages