Release 0.0.23

README.md

@@ -9,7 +9,7 @@ Safe direct-style concurrency and resiliency for Scala on the JVM. Requires JDK
 [sbt](https://www.scala-sbt.org) dependency:
 
 ```scala
-"com.softwaremill.ox" %% "core" % "0.0.22"
+"com.softwaremill.ox" %% "core" % "0.0.23"
 ```
 
 Documentation is available at [https://ox.softwaremill.com](https://ox.softwaremill.com).

generated-doc/out/fork-local.md

@@ -0,0 +1,30 @@
+# Fork locals
+
+`ForkLocal`s replace usages of `ThreadLocal` when using ox's forks and structural concurrency. They are useful to
+propagate auxiliary context, e.g. trace or correlation ids.
+
+Implementation note: `ForkLocal`s are based on `ScopedValue`s, which are part of [JEP 429](https://openjdk.org/jeps/429).
+
+A fork local needs to be first created with a default value. Then, its value can be set within a new [scope](fork-join.md).
+Usually, a new supervised scope is created, within which the `ForkLocal` is set to the given value - but only within that
+scope, as long as it's not completed. Hence, values are bound structurally:
+
+```scala
+import ox.{ForkLocal, fork, supervised}
+
+val v = ForkLocal("a")
+supervised {
+  println(v.get()) // "a"
+  fork {
+    v.supervisedWhere("x") {
+      println(v.get()) // "x"
+      fork {
+        println(v.get()) // "x"
+      }.join()
+    }
+  }.join()
+  println(v.get()) // "a"
+}
+```
+
+Scoped values propagate across nested scopes.

generated-doc/out/index.md

@@ -10,7 +10,7 @@ In addition to this documentation, ScalaDocs can be browsed at [https://javadoc.
 ## sbt dependency
 
 ```scala
-"com.softwaremill.ox" %% "core" % "0.0.22"
+"com.softwaremill.ox" %% "core" % "0.0.23"
 ```
 
 ## Scope of the project
@@ -67,7 +67,7 @@ We offer commercial support for ox and related technologies, as well as developm
    error-handling
    fork-join
    error-handling-scopes
-   scoped-values
+   fork-local
    retries
    interruptions
    resources

generated-doc/out/kafka.md

@@ -3,7 +3,7 @@
 Dependency:
 
 ```scala
-"com.softwaremill.ox" %% "kafka" % "0.0.22"
+"com.softwaremill.ox" %% "kafka" % "0.0.23"
 ```
 
 `Source`s which read from a Kafka topic, mapping stages and drains which publish to Kafka topics are available through