Methods can be impure

Fixes #385.

1 files changed, 4 insertions, 0 deletions

diff --git a/docs/src/reference/types.md b/docs/src/reference/types.md
index b87b0779..c323ab41 100644
--- a/docs/src/reference/types.md
+++ b/docs/src/reference/types.md
@@ -822,6 +822,10 @@ In Typst, all functions are _pure._ This means that for the same
 arguments, they always return the same result. They cannot "remember" things to
 produce another value when they are called a second time.
 
+The only exception are built-in methods like
+[`array.push(value)`]($type/array.push). These can modify the values they are
+called on.
+
 ## Methods
 ### with()
 Returns a new function that has the given arguments pre-applied.