0.8.0 time!

[travisbrown]

I'd like to get an 0.8.0 release out sooner rather than later (see discussion on Gitter), so I thought I'd get the ball rolling with a first draft of the release notes.

I'll also start a checklist for things that need to happen before the release. I'm only including PRs that other people have expressed an interest in seeing in this release (e.g. #1382) or that look ready-to-go and non-controversial, but we can add others if there's other stuff people want in 0.8.

• Make a decision on Fix for #1297 #1334 (rename Bifunctor to Functor2, etc.)
• Merge Add stackUnsafeMonad to MonadTests #1417 (stackUnsafeMonad laws, has two 👍s)
• Merge Add diagram of typeclass hierarchy continue #822 #1416 (type class hierarchy diagram, two 👍s)
• Merge UUID instances #1399 (instances for UUID, has two 👍s)
• Merge Adding sequenceM method to Traverse #1394 (flatTraverse and flatSequence, has two 👍s)
• Merge Scala 2.12.0-RC2 #1415 (Scala 2.12.0-RC2 support, three 👍s)
• Review and merge Add toNestedValidated and toNestedValidatedNel #1408 (toNestedValidated for EitherT, one 👍)
• Review and merge More instances for prod #1402 (more Prod instances, two 👍 s)
• Review and merge Add foldMap/compile FunctionK to Free companion #1411 (Free.foldMap and compile)
• Add Xor-to-Either migration guide
• Review and merge Clarify some details about the life and death of Xor #1428 (minor clarification in FAQ about Xor and Either)
• Review FAQ entry about required stack safety of tailRecM (Add FAQ entry for tailRecM #1427)
• Finalize release notes

I'll take care of finalizing the release notes, and could take a stab at the migration guide and tailRecM notes, but someone else might be able to get to those two tasks before me.

[adelbertc]

Does https://github.com/typelevel/cats/blob/master/docs/src/main/tut/faq.md#where-is-right-biased-either count for Add Xor-to-Either migration guide ?

[travisbrown]

@adelbertc Linking to the FAQ might be enough, but I'd like to confirm that just replacing Xor with Either and adding the import works on some real-world projects. Also I don't remember the details about which combinations of imports end up with slow flatMap, etc., and I want to be sure we cover issues like that.

[codecov-io]

Current coverage is 92.28% (diff: 100%)

Merging #1412 into master will increase coverage by 0.07%

@@             master      #1412   diff @@
==========================================
  Files           242        242          
  Lines          3606       3680    +74   
  Methods        3537       3611    +74   
  Messages          0          0          
  Branches         69         69          
==========================================
+ Hits           3325       3396    +71   
- Misses          281        284     +3   
  Partials          0          0          

Powered by Codecov. Last update 93a4d6a...b322309

[SethTisue]

re: 2.12 support, #1377 too

[kailuowang]

How about we add a FAQ around the now required(#1370) stack safe tailRecM on FlatMap this release?
I have a feeling that people will have questions regarding this, rationale, implementation guidance, etc. E.g. One helpful discussion can be found here,#1329.

[travisbrown]

@SethTisue I think that's handled satisfactorily in #1415 now.

[travisbrown]

@kailuowang Yes, good idea—I've added it to the list.

[travisbrown]

I've just brought the changelog up to date with master as of right now.

[travisbrown]

@andyscott, @benhutchison, @cb372, @conniec, @estsauver, @MasseGuillaume, @israelperezglez, @jhzab, @jon-hanson, @Fristi, @pepegar, @rafaparadela, @rklaehn, @sritchie, @tixxit: I've added all of you to the AUTHORS.md list since you have commits in this release. If you'd prefer not to be included in the list, or if you'd prefer to be listed with a spelling of your name that's different from what I've inferred from the email address on the commit(s), please let me know!

[philwills]

With regards to Xor to Either on real world projects, I've just done scanamo/scanamo#67. By and large it was easier and more mechanical than I was expecting. The only exception was that I needed to add an explicit type to a leftMap here: https://github.com/guardian/scanamo/pull/67/files#diff-930653acd86ea5d81c2c41062ff623e8R33

Oh and the FAQ doesn't mention that you might need to import the instances as well as the syntax.

[peterneyens]

Small typo here: improvments.

[travisbrown]

Eek, thanks @peterneyens. I've just pushed a fix.

[travisbrown]

Thanks, @philwills—how does #1430 look?

[non]

This looks ready to go to me. 👍

Thanks everyone for all your hard work making this happen. (And especially to @travisbrown for navigating the process.)

Let's open an issue to discuss what we need for 1.0 next (for example, we need to make a decision about MTL).

[travisbrown]

Thanks, @non! Any idea when we should expect the release?

[non]

I'm fine with releasing this morning if folks agree that it's ready.