From 6cfbff4b6b8257221e9b8e7c40b915701da9916f Mon Sep 17 00:00:00 2001 From: Luca Tassinari Date: Tue, 5 Mar 2024 16:15:17 +0100 Subject: [PATCH] docs: init review of documentation --- docs/content/docs/00-overview | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 docs/content/docs/00-overview diff --git a/docs/content/docs/00-overview b/docs/content/docs/00-overview new file mode 100644 index 00000000..4cc8adad --- /dev/null +++ b/docs/content/docs/00-overview @@ -0,0 +1,31 @@ +# ... + +## Context + +In the realm of asynchronous programming, the Scala ecosystem offers a set of solid monads constructs and libraries to tackle complex task functionally with elegance and efficiency, like Monix Tasks and Cats Effect. + +However, we are assisting to the increase in adoption of continuation and coroutines in modern runtimes, either exploiting some kind of fibers support, like the project Loom with Virtual Threads, or via code generation, like Kotlin Coroutines. + +## Goals + +The goal of this project is to delve into this field through the lens of direct style, developing few examples (not too complex) leveraging the new strawman library Scala Gears, comparing it with Kotlin's Coroutines and the current implementation of monadic Futures, seeking to analyze aspects such as: + +- ergonomics of the two styles (which one results more thoughtful and/or verbose); +- which of the two approaches has a real advantage in adoption; +- pros and cons of the two styles; +- any limitations and difficulties encountered in using them. + +## The contribution + +The project is built around three main examples, focusing on different aspects. +The first is bout + + + + + + +## References + +## Conclusions +