Most awesome FP libraries (Cats, Scalaz, Monocle, Algebird etc ) have microsite done by sbt-microsites

Adding one for Shapeless would make it easier for newcomers. Quick, online reference on what is available

It should cover when you'd use and how to use:

• parEvalMap/Unordered
• parJoin
• concurrently
• merge*

There's the page on Queue/Topic/etc but there's not a great single page on the operations directly on Stream. The Guide section on concurrency is very short and doesn't cover some of the most common operations (parEvalMap especially)

We have several quite large examples that live in our docs:

1. https://github.com/dry-python/returns/blob/master/docs/pages/future.rst#futureresult
2. Number example from: https://github.com/dry-python/returns/blob/master/docs/pages/contrib/hypothesis_plugins.rst#check_all_laws
3. https://github.com/dry-python/returns/blob/master/docs/pages/context.rst#requirescontextfutureresult-container

It would make the resource wrap an effect in an usage, ignoring the value produced by the resource.

Possible signature:

trait Resource[+F[_], +A] { self =>
  //...

  //some constraint might be required on G
  def surround[G[x] >: F[x]]: G ~> G = new (G ~> G) { def apply[A](ga: G[A]): G[A] = self.use(_ => ga) }
}