add Stream.run/1

Author: superruzafa

assets/images/functions/Stream/run-1.tex

@@ -0,0 +1,21 @@
+\matrix [list=a, opacity=0.5] {
+  \node [index=1]; &
+  \node [index=2]; &
+  \node [elements between]; &
+  \node [index=n]; \\
+};
+
+\matrix [list=b, element=a, right=1 of list a] {
+  \node [index=1]; &
+  \node [index=2]; &
+  \node [elements between]; &
+  \node [index=n]; \\
+};
+
+\coordinate (x) at ($ (list a.east)!.5!(list b.west) $);
+
+\node at (x) {$\Rightarrow$};
+
+\node (x) [below=1 of x] {$\Downarrow$};
+\node [below=of x] {\texttt{:ok}};
+

content/en/functions/Stream/run-1.md

@@ -1,12 +1,10 @@
 ---
 title: run/1
 url: /Stream/run/1
-draft: true
 ---
 
-# `Stream.run/1`
-Brief description and usage of the `Stream`'s `run/1` function.
+Materializes the given `stream`.
+
+This is useful when a stream needs to be run, for side effects, and there is no interest in its return result.
 
 {{< figure src="images/functions/Stream/run-1.svg" >}}
-{{< figure src="images/functions/Stream/run-1.2.svg" >}}
-{{< figure src="images/functions/Stream/run-1.3.svg" >}}

data/signatures.yaml

@@ -1118,6 +1118,11 @@
         defmodule Stream do
           def resource(start_fun, fun, after_fun)
         end
+    - name: run/1
+      signature: |
+        defmodule Stream do
+          def run(stream)
+        end
     - name: scan/2
       signature: |
         defmodule Stream do