Add Task.ignore (#272)

Author: odytrice

gitbook/task/ignore.md

@@ -0,0 +1,27 @@
+## Task.ignore
+
+Namespace: `FsToolkit.ErrorHandling`
+
+Function Signature:
+
+```fsharp
+Task<'a> -> Task<unit>
+```
+
+This is a shortcut for `Task.map ignore`.
+
+## Examples
+
+### Example 1
+
+```fsharp
+let savePost : CreatePostRequest -> Task<PostId, exn>
+```
+
+We can call this with the `do!` syntax inside a computation expression using `Task.ignore` as below:
+
+```fsharp
+let makePost = task {
+  do! savePost createPostRequest |> Task.ignore
+}
+```

src/FsToolkit.ErrorHandling.TaskResult/Task.fs

@@ -45,6 +45,10 @@ module Task =
 
     let inline map3 ([<InlineIfLambda>] f) x y z = apply (map2 f x y) z
 
+    /// Allows us to call `do!` syntax inside a computation expression
+    let inline ignore (x: Task<'a>) =
+        x
+        |> map ignore
 
     /// Takes two tasks and returns a tuple of the pair
     let zip (a1: Task<_>) (a2: Task<_>) =