Add some notes on Try.@function (#35)

JuliaPreludes · Mar 21, 2022 · 631e6a6 · 631e6a6
1 parent ad39786
commit 631e6a6
Showing 1 changed file with 9 additions and 1 deletion.
diff --git a/src/docs/@function.md b/src/docs/@function.md
@@ -2,7 +2,15 @@
 
 Create a function that can be called without causing a `MethodError`.
 
-See also: [`istryable`](@ref).
+Note that [`Ok`](@ref) and [`Err`](@ref) values can be used in arbitrary functions.
+`Try.@function fn` is simply a shorthand for defining a fallback implementation
+
+    fn(args...; kwargs...) = Err(Try.NotImplementedError(fn, args, values(kwargs)))
+
+(and auxiliary methods like [`Try.istryable`](@ref)) to help the ["Easier to ask for
+forgiveness than permission" (EAFP)](https://github.com/tkf/Try.jl#eafp) approach.
+
+See also: [`Try.istryable`](@ref).
 
 # Examples