[
  {"group":"Identity and alternate names","fields":["id","name","type","is_expansion","names[].type","names[].sort_index","names[].value"],"scope":"Core identity in lists; names in detail","description":"BGG ID, primary name, record type, expansion flag, and primary/alternate names with source sort order."},
  {"group":"Description and publication","fields":["description","year_published","yearpublished"],"scope":"Year in lists; description and legacy alias in detail","description":"Source description may contain HTML or encoded text. year_published is canonical; yearpublished is a legacy alias when present."},
  {"group":"Players, time and age","fields":["min_players","max_players","min_playtime","max_playtime","playing_time","min_age"],"scope":"List and detail","description":"Published player range, minimum/maximum and typical playing time in minutes, and publisher/source minimum age. Community recommendations are separate."},
  {"group":"Images","fields":["image_url","thumbnail_url"],"scope":"List and detail","description":"Source image and thumbnail URLs. Availability and third-party image rights vary."},
  {"group":"People and taxonomy","fields":["artists[].id","artists[].value","designers[].id","designers[].value","publishers[].id","publishers[].value","families[].id","families[].value","mechanics[].id","mechanics[].value","categories[].id","categories[].value"],"scope":"List and detail","description":"Source identifiers and labels for artists, designers, publishers, families, mechanics and categories. Lists retain the ID/value tuples."},
  {"group":"Ratings and rating spread","fields":["rating.users_rated","rating.average","rating.bayes_average","rating.stddev","rating.median"],"scope":"List and detail","description":"Community rating count, average, Bayesian average, standard deviation and source median. Zero values can be source placeholders, not meaningful measurements."},
  {"group":"Ownership and interest","fields":["rating.owned","rating.trading","rating.wanting","rating.wishing","rating.num_comments"],"scope":"List and detail","description":"Source community collection, trade, want, wish and comment counts. These are not current marketplace inventory or sales."},
  {"group":"Complexity","fields":["rating.num_weights","rating.average_weight"],"scope":"List and detail","description":"Number of complexity votes and average source complexity weight, on the source 1–5 scale."},
  {"group":"Overall and category ranks","fields":["rank","ranks[].type","ranks[].id","ranks[].name","ranks[].friendly_name","ranks[].value","ranks[].bayes_average"],"scope":"List and detail","description":"Overall rank and category rank entries. Ranked-list responses instead include categoryRank, categoryBayes and overallRank."},
  {"group":"Community player recommendations","fields":["suggested_players.<player-count>.<vote-label>"],"scope":"Detail only","description":"Vote counts for Best, Recommended and Not Recommended, keyed by player count (including labels such as 4+). Not a replacement for the published player range."},
  {"group":"Language dependence","fields":["suggested_language_dependence.<answer>"],"scope":"Detail only","description":"Community votes describing how much in-game text affects playability in another language."},
  {"group":"Full community polls","fields":["poll_results.<poll-name>.title","poll_results.<poll-name>.total_votes","poll_results.<poll-name>.results[].numplayers","poll_results.<poll-name>.results[].votes.<answer>"],"scope":"Detail only","description":"Full player-count, suggested-age and language-dependence poll results. Poll names and answer keys can vary; numplayers may be null. Do not sum all response buckets to infer unique voters."},
  {"group":"Freshness and source status","fields":["last_updated","fetch_success"],"scope":"Timestamp in lists; optional status in detail","description":"Stored source-fetch timestamp and optional ingest success flag. Preserve the timestamp as supplied; it may omit a timezone. Neither establishes a refresh SLA."},
  {"group":"Legacy summary aliases","fields":["average","bayesaverage","usersrated","<category>_rank"],"scope":"Detail only, when present","description":"Older top-level rating and category-rank aliases, such as familygames_rank, strategygames_rank and thematic_rank. Prefer rating and ranks for new integrations; do not assume aliases always exist."}
]
