diff --git a/src/core/DataHelper.ttslua b/src/core/DataHelper.ttslua
index f2aa0b10..bbb584bf 100644
--- a/src/core/DataHelper.ttslua
+++ b/src/core/DataHelper.ttslua
@@ -526,10 +526,6 @@ function setSpawnedPlayerCardGuid(params)
   end
 end
 
--- deprecated, use metadata (GM Notes) instead (still used by custom data helpers)
--- Encounter Cards with "Hidden."
-HIDDEN_CARD_DATA = {}
-
 -- called by "Global" during encounter card drawing
 function checkHiddenCard(name)
   for _, n in ipairs(HIDDEN_CARD_DATA) do
@@ -550,28 +546,31 @@ function updateHiddenCards(args)
 end
 
 --------------------------------------------------------------------------
--- deprecated code (commented out)
+-- deprecated code, kept here for existing calls
 --------------------------------------------------------------------------
 
 -- deprecated, use metadata (GM Notes) instead
 -- Known locations and clues. We check this to determine if we should atttempt to spawn clues,
 -- first we look for <LOCATION_NAME>_<GUID> and if we find nothing we look for <LOCATION_NAME>
 -- format is [location_guid -> clueCount]
--- LOCATIONS_DATA = JSON.decode([[{
---   "XXXX": {"type": "fixed", "value": 2, "clueSide": "back"},
---   "xxx": {"type": "perPlayer", "value": 2, "clueSide": "back"}
--- }]])
+
+-- Example 1: "Study" from Core Set (https://arkhamdb.com/card/01111)
+-- ["Study"]= {type="perPlayer", value=2, clueSide= "back"}
+
+-- Example 2:  "Student Union" from Dunwich Legacy (https://arkhamdb.com/card/02051)
+-- ["Student Union"]= {type="fixed", value= 2, clueSide= "back"}
+LOCATIONS_DATA = {}
 
 -- deprecated, use metadata (GM Notes) instead
 -- Player cards with token counts and types
--- PLAYER_CARD_DATA = JSON.decode([[{
---   "xxx": {
---   "tokenType": "resource",
---   "tokenCount": 3
---   }
--- }]])
 
--- deprecated, included in TokenManager
--- PLAYER_CARD_TOKEN_OFFSETS = {
---   [1] = {{ 0, 3, -0.2 }}
--- }
\ No newline at end of file
+-- Example: "Flashlight" from Core Set (https://arkhamdb.com/card/01087)
+-- ["Flashlight"]= {tokenType= "resource", tokenCount= 3}
+PLAYER_CARD_DATA = {}
+
+-- deprecated, use metadata (GM Notes) instead (still used by custom data helpers)
+-- Encounter Cards with "Hidden." (List of names)
+
+-- Example: "Possession (Murderous)" from Path to Carcosa (https://arkhamdb.com/card/03342)
+-- ..., "Possession (Murderous)", ...
+HIDDEN_CARD_DATA = {}