diff --git a/docs/scarpet/Full.md b/docs/scarpet/Full.md
index b5aec1b9..cae98c9d 100644
--- a/docs/scarpet/Full.md
+++ b/docs/scarpet/Full.md
@@ -2893,7 +2893,10 @@ In this case - entities would need to be re-fetched, or the code should account
 
 ### `player(), player(type), player(name)`
 
-With no arguments, it returns the calling player or the player closest to the caller. Note that the main context 
+With no arguments, it returns the calling player or the player closest to the caller. 
+For player-scoped apps (which is a default) its always the owning player or `null` if it not present even if some code
+still runs in their name.
+Note that the main context 
 will receive `p` variable pointing to this player. With `type` or `name` specified, it will try first to match a type, 
 returning a list of players matching a type, and if this fails, will assume its player name query retuning player with 
 that name, or `null` if no player was found. With `'all'`, list of all players in the game, in all dimensions, so end