starting on parallel doc

darrenjw · Sep 9, 2023 · d1ddf96 · d1ddf96
1 parent 528afd4
commit d1ddf96
Show file tree

Hide file tree

Showing 3 changed files with 41 additions and 3 deletions.
diff --git a/Scala/docs/Parallel.md b/Scala/docs/Parallel.md
@@ -1,5 +1,24 @@
-# Scala parallel crash course
+# Scala parallel programming crash course
 
+## Parallel collections
 
+This simplest (but by no means the only) way to get started with parallel programming in Scala is using Scala [parallel collections](https://docs.scala-lang.org/overviews/parallel-collections/overview.html).
 
+```scala
+val rng = scala.util.Random(42)
+val v = Vector.fill(10)(rng.nextGaussian)
+v
+
+```
+
+
+
+## Futures
+
+
+
+
+## Effects
+
+Futures are a powerful and flexible way to construct parallel and concurrent applications. However, they aren't a perfect fit to a pure functional approach to programming. The fact that futures "fire" as soon as they are created means that they have a *side-effect*, and that is potentially problematic. People have developed more principled, functional effects systems for Scala, such as the [Cats effect](https://typelevel.org/cats-effect/) IO monad, and these provide better mechanisms for parallel and concurrent programming in Scala. They are, however, (well) beyond the scope of this course. 
 
diff --git a/Scala/md/Parallel.md b/Scala/md/Parallel.md
@@ -1,5 +1,24 @@
-# Scala parallel crash course
+# Scala parallel programming crash course
 
+## Parallel collections
 
+This simplest (but by no means the only) way to get started with parallel programming in Scala is using Scala [parallel collections](https://docs.scala-lang.org/overviews/parallel-collections/overview.html).
 
+```scala
+val rng = scala.util.Random(42)
+val v = Vector.fill(10)(rng.nextGaussian)
+v
+
+```
+
+
+
+## Futures
+
+
+
+
+## Effects
+
+Futures are a powerful and flexible way to construct parallel and concurrent applications. However, they aren't a perfect fit to a pure functional approach to programming. The fact that futures "fire" as soon as they are created means that they have a *side-effect*, and that is potentially problematic. People have developed more principled, functional effects systems for Scala, such as the [Cats effect](https://typelevel.org/cats-effect/) IO monad, and these provide better mechanisms for parallel and concurrent programming in Scala. They are, however, (well) beyond the scope of this course. 
 
diff --git a/Scala/md/ScalaCC.md b/Scala/md/ScalaCC.md
@@ -139,7 +139,7 @@ def linFun(m: Double, c: Double)(x: Double): Double =
   m*x + c
 
 val f = linFun(2, 3)
-// f: Function1[Double, Double] = repl.MdocSession$MdocApp$$Lambda$8059/0x0000000802036010@781857e7
+// f: Function1[Double, Double] = repl.MdocSession$MdocApp$$Lambda$8067/0x00000008020f5e08@4afe4c5d
 
 f(0)
 // res22: Double = 3.0