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

Draft of 0.7.0 release notes #1259

Merged
merged 10 commits into from
Aug 21, 2016

Conversation

travisbrown
Copy link
Contributor

@travisbrown travisbrown commented Aug 2, 2016

I still think we should include an update guide, but this is a first stab at #1253.

This is ready to be reviewed, apart from the fact that #1264, #1265, #1266 (saving for next release), and #1267 aren't yet included.

@codecov-io
Copy link

codecov-io commented Aug 2, 2016

Current coverage is 90.63% (diff: 100%)

Merging #1259 into master will not change coverage

@@             master      #1259   diff @@
==========================================
  Files           237        237          
  Lines          3725       3725          
  Methods        3663       3663          
  Messages          0          0          
  Branches         58         58          
==========================================
  Hits           3376       3376          
  Misses          349        349          
  Partials          0          0          

Sunburst

Powered by Codecov. Last update 6140bb7...edbcb43

And some name changes:

* [#1140](https://github.com/typelevel/cats/pull/1140): `cats.std` is now `cats.instances`
* [#1201](https://github.com/typelevel/cats/pull/1201): Many `*Unsafe` methods are now `unsafe*`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This PR wasn't merged.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, thanks @fthomas. There's a possibility there's also stuff still missing—I'll do a closer pass this afternoon.

@travisbrown
Copy link
Contributor Author

I went ahead and added commits adding new contributors and updating versions as described in the process document.

@kailuowang
Copy link
Contributor

#1264 was merged. It's not clear to me why #1265 and #1267 are not merged yet (seems they both got enough sign-offs).

@travisbrown
Copy link
Contributor Author

@kailuowang Yeah, I wanted to wait for all three NonEmpty* PRs to land before updating the release notes.


Version 0.7.0 is the seventh Cats release, and includes several major rearrangements and changes to names.

### Migration notes
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for adding this section @travisbrown. I think this will be really helpful for people.

@johnynek
Copy link
Contributor

I'd love to finish #1280 before 0.7.0. It would be a shame to have 0.7.0 introduce FlatMapRec only to remove it in the next release.

I can get 1280 passing in a day or two if we can wait.

@travisbrown travisbrown changed the title Draft of 0.7.0 release notes (do not merge yet) Draft of 0.7.0 release notes Aug 19, 2016

* All references to `cats.std` will need to be changed to `cats.instances` ([#1140](https://github.com/typelevel/cats/pull/1140)). If you're using `cats.std.all` or the other `cats.std` objects with wildcard imports, this is likely to be the only change you need to make. If you are importing or referring to instance definitions by name, you'll need to be aware that the naming convention has changed (see [#1066](https://github.com/typelevel/cats/pull/1066), [#1068](https://github.com/typelevel/cats/pull/1068), [#1110](https://github.com/typelevel/cats/pull/1110), and [#1122](https://github.com/typelevel/cats/pull/1122)).
* `NonEmptyList` and `NonEmptyVector` are no longer type aliases for `OneAnd`, so any code using `OneAnd` to construct or pattern match on these types will need to be changed to use `NonEmptyList` or `NonEmptyVector` directly. There are also some API changes; for example, `unwrap` calls will need to be replaced by `toList` or `toVector`, and `NonEmptyList(1, 2, 3)` is now `NonEmptyList.of(1, 2, 3)`.
* `pureEval` has been removed from `Applicative` ([#1234](https://github.com/typelevel/cats/pull/1234)), and has not been replaced, so if you are relying on it for laziness or effect capturing (which wasn't enforced or guaranteed), you'll need to find another approach.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What I suggested was to require a NaturalTransformation[Eval, M] if you need to create an M[T] from an Eval[T]. For M[T] with laziness, you can do something non-trivial.

@non
Copy link
Contributor

non commented Aug 21, 2016

LGTM 👍

@non
Copy link
Contributor

non commented Aug 21, 2016

Since this is documentation I'm going to merge this after one +1.

@non non merged commit 107de46 into typelevel:master Aug 21, 2016
@non non removed the in progress label Aug 21, 2016
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

Successfully merging this pull request may close these issues.

7 participants