fp

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 need to add .. autosummary:: to pages that need it.
We also need to make sure that this tag renders smoothly.

Usage example: https://github.com/wemake-services/wemake-python-styleguide/blob/ba060dfd18606365d4c09545554b595fce025e79/wemake_python_styleguide/violations/best_practices.py#L16-L17
Docs: https://www.sphinx-doc.org/en/master/usage/extensions/autosummary.html

Should return something like IO[Trace], which should be an immutable data type containing methods like enhanceException(Throwable): Throwable, pretty: String, oneline: String (or maybe just toString), etc. This handles use-cases like ad-hoc debugging and external exception handlers (like Sentry).

I'm labeling this as a good first issue even though it's going to be a bit involved