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
| Type | File | Role |
|---|---|---|
manifest | oadf.yaml | Package version and optional index |
club | *.club.yaml | Members and coach→archer links |
person | *.person.yaml | One archer and/or coach |
programme | *.programme.yaml | Multi-session plan, no scores |
session_template | *.session-template.yaml | One practice plan, no date |
session | *.session.yaml | One dated practice |
scorecard | *.scorecard.yaml | Scored arrows |
bulk | *.bulk.yaml | Arrow counts without per-arrow scores |
equipment | *.equipment.yaml | One gear item and its revisions |
| series | *.csv | Dense samples, as a sidecar |
| media | jpg, png, webp, heic | Photos, as sidecars |
Rules that stay fixed in version 1
- Every YAML document starts with
oadf: 1andtype. - A score that was not entered is omitted.
Mor0is a miss. A blank is not a miss. - Face plots use the centre as origin, +x right, +y up, and radius 10 at the outer edge.
- Times are UTC with a
Zsuffix. Dates areYYYY-MM-DD. - Samples and photos stay in sidecar files. They are never inlined in YAML.
- Unknown keys are kept and written back unchanged.
JSON with the same object shape is allowed. The file then ends in .json.