diff --git a/docs/scarpet/Full.md b/docs/scarpet/Full.md
index 4b41f448..0c427544 100644
--- a/docs/scarpet/Full.md
+++ b/docs/scarpet/Full.md
@@ -4311,8 +4311,9 @@ With specified `objective` and
  
 ### `scoreboard_add(objective, criterion?)`
 
-Adds a new objective to scoreboard. If `criterion` is not specified, assumes `'dummy'`. Returns `false` if objective 
-already existed, `true` otherwise.
+Adds a new objective to scoreboard. If `criterion` is not specified, assumes `'dummy'`.
+If the objective already exists, changes the criterion of that objective and returns `false`. If the criterion was not specified but the objective already exists, returns the current criterion.
+If the objective was added, returns `true`. If nothing is affected, returns `null`
 
 <pre>
 scoreboard_add('counter')
@@ -4463,7 +4464,6 @@ for(bossbar(),bossbar(_,'remove'))  -> remove all bossbars
 
 
 
-
 # Auxiliary aspects
 
 Collection of other methods that control smaller, yet still important aspects of the game