Version 1

Open Archery Data Format

A directory of YAML and CSV for archery training. The same package is meant to be read by a person, a statistics tool, or a language model.

A package holds clubs, people, programmes, sessions, scores, equipment, sensor series, and photos. A zip is only transport: unpacking restores the same tree. The text of the specification is the contract. The worked package is the oracle.

A package

The root holds oadf.yaml. Every path inside a document is relative to that root. This tree is the shape; the names are an illustration.

oadf.yaml
Athens Archery.club.yaml
people/maria.person.yaml
programmes/form-block.programme.yaml
archers/maria/2026-10-20.session.yaml
archers/maria/scorecards/2026-10-20-1820.scorecard.yaml
archers/maria/bulk/2026-10-20-1802.bulk.yaml
archers/maria/series/heart-2026-10-20.csv
archers/maria/media/end-1-1.jpg
archers/maria/equipment/indoor-recurve.equipment.yaml

Documents

TypeFileRole
manifestoadf.yamlPackage version and optional index
club*.club.yamlMembers and coach→archer links
person*.person.yamlOne archer and/or coach
programme*.programme.yamlMulti-session plan, no scores
session_template*.session-template.yamlOne practice plan, no date
session*.session.yamlOne dated practice
scorecard*.scorecard.yamlScored arrows
bulk*.bulk.yamlArrow counts without per-arrow scores
equipment*.equipment.yamlOne gear item and its revisions
series*.csvDense samples, as a sidecar
mediajpg, png, webp, heicPhotos, as sidecars

Rules that stay fixed in version 1

JSON with the same object shape is allowed. The file then ends in .json.