1.3  Canonical Records

Challenge and dataset pages have one editable source each. The documentation book should link to those records rather than copy their status, access commands, baselines, or protocol text.

1.3.1 Challenge Records

Edit Renders To
challenges/<challenge-id>/challenge.qmd /challenges/<challenge-id>/

Use the challenge record for task scope, status, detector type, metrics, dataset links, baseline source, validation commands, citations, and math.

1.3.2 Dataset Records

Edit Renders To
datasets/<dataset-id>/dataset.qmd /data-hub/<dataset-id>/

Use the dataset record for dataset status, access commands, schema links, used-by relationships, citations, and dataset-specific notes.

1.3.3 Shared Documentation

Use the documentation book for material that applies across records:

  • challenge rules and submission conventions
  • metric definitions
  • physics background
  • software stack notes
  • contribution workflow
  • dataset schema notes