Deprecate foreach in API

On principle, Cats has not provided foreach methods for most of its datatypes as this method implies side-effects. To be consistent, the following methods should be marked deprecated, documenting the suggested workarounds of either:

• using IO.traverse or
• using alleycats foreach additions to Foldable

core/src/main/scala/cats/data/Ior.scala
84:  final def foreach(f: B => Unit): Unit = {

core/src/main/scala/cats/data/Validated.scala
31:  def foreach(f: A => Unit): Unit = this match {

core/src/main/scala/cats/syntax/either.scala
38:  def foreach(f: B => Unit): Unit = eab match {

Start with the listed foreach methods in core/src/main/scala/cats/data/Ior.scala, core/src/main/scala/cats/data/Validated.scala, and core/src/main/scala/cats/syntax/either.scala. Review the surrounding API and deprecation conventions, then verify that each method documents IO.traverse or alleycats foreach as the suggested workaround and that the affected Scala tests still pass.