Skip to content

docs: finish sport-scoping framing in spec doc; recover lost review edits #37

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
OliEder merged 1 commit into from
Aug 27, 2026
Merged

docs: finish sport-scoping framing in spec doc; recover lost review edits #37

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/specification-v1.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
= Open Coaching Format — Open Standard for Basketball Drill Diagrams
= Open Coaching Format — Open Standard for Team-Sport Coaching Diagrams
:version: 1.2.0
:doctype: book
:toc: left
Expand All @@ -22,7 +22,7 @@
[abstract]
== Abstract

*{ocf} v{version}* is an open, ruleset-aware JSON schema for representing basketball drill diagrams and multi-step animations.
*{ocf} v{version}* is an open, ruleset-aware JSON schema for representing team-sport coaching diagrams and multi-step animations — targeting invasion team sports, with basketball fully defined first.
It defines a court coordinate system based on real-world units (meters or feet), a registry of named court positions per ruleset,
a semantic entity model, and a frame-based animation structure.

Expand All @@ -40,7 +40,7 @@ The format is designed to be:

=== Motivation

No open standard exists for basketball drill diagrams.
No open standard exists for team-sport coaching diagrams.
All major tools (FIBA Europe Coaching App, FastDraw, Sportplan.net) use proprietary formats with image-only export.
This prevents programmatic drill creation, LLM-assisted coaching tools, and cross-platform interoperability.

Expand Down Expand Up @@ -1295,7 +1295,7 @@ Coordinate <|-- RelativeCoordinate
| `area.form` | `rectangle`, `ellipse`, `triangle`
| `color_role` | `offense`, `defense`, `black`, `grey`, `yellow`, `green`, `red`, `blue`, `white`
| `unit` | `m`, `ft`
| Action `type` | move, cut, screen, defend, dribble, pass, shoot, rebound, pickup
| Action `type` | move, cut, screen, defend, dribble, pass, shoot, rebound, pickup, tackle, clear, faceoff, check (valid subset depends on `sport` — see the Sport section)
| Cut `variant` | backdoor, give_and_go, flash, v_cut, l_cut, curl, flare, fade, basket
| Screen `variant` | ball_screen, back_screen, down_screen, flare_screen, cross_screen, pin_down
| Defend `variant` | on_ball, deny, help, hedge, switch, box_out
Expand Down
7 changes: 4 additions & 3 deletions examples/sport-soccer.ocf.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,13 @@
"court": { "ruleset": "custom", "type": "full_court", "custom_dimensions": { "unit": "m", "length": 105, "width": 68, "basket_from_baseline": 0, "three_point_distance": 0, "paint_width": 40.3, "paint_depth": 16.5, "free_throw_distance": 11 } },
"entities": [
{ "type": "offense", "nr": 9, "x": 0.0, "y": 30.0 },
{ "type": "offense", "nr": 8, "x": 12.0, "y": 28.0 },
{ "type": "defense", "nr": 4, "x": 0.0, "y": 40.0 }
],
"balls": [ { "id": "ball_1", "carried_by": "offense_9" } ],
"frames": [
{ "id": "f1", "label": "Tackle", "description": "defender challenges",
"actions": [ { "player": "defense_4", "type": "tackle" }, { "player": "offense_9", "type": "pass", "to_player": "offense_9" } ],
"end_state": { "offense_9": { "x": 0.0, "y": 30.0 }, "defense_4": { "x": 0.0, "y": 38.0 } } }
{ "id": "f1", "label": "Tackle", "description": "defender challenges the ball carrier, who releases a pass",
"actions": [ { "player": "defense_4", "type": "tackle" }, { "player": "offense_9", "type": "pass", "to_player": "offense_8" } ],
"end_state": { "offense_9": { "x": 0.0, "y": 30.0 }, "offense_8": { "x": 12.0, "y": 28.0 }, "defense_4": { "x": 0.0, "y": 38.0 } } }
]
}
Loading