Skip to content

Latest commit

 

History

History
124 lines (88 loc) · 6.77 KB

GLOSSARY.md

File metadata and controls

124 lines (88 loc) · 6.77 KB

Open Caddie

Open Caddie records golf courses, rounds, matches, tournaments, and club standings.

Language

Player: A person known to Open Caddie, whether or not they have ever signed in. The golf-facing view of a person: they play Rounds, create Matches, belong to Clubs, and carry a Player Index in each Club. Avoid: User (outside sign-in), golfer, member (for the person itself)

User: A Player's sign-in identity: how a person authenticates and holds a session. Used only when talking about signing in. Avoid: User as a synonym for Player, account (for the person itself)

Platform Admin: A Player permitted to manage anything in Open Caddie: any Club, Tournament, Match, Round or Player. It is a trait of the Player, not of their sign-in, and not tied to any Club. Avoid: Admin (alone), site admin, superuser

Club: A golf group whose Players compete in its Tournaments, grouped into its Seasons.

Club Membership: A Player's membership in a Club. The people themselves are the Club's Players. Avoid: Club Member, member (for the Player)

Event: A Tournament or a Match: it fixes the course, date and starting tee of the Rounds played in it. A Round with no Event is a casual Round. Avoid: game, outing

Tournament: A Club-owned Event belonging to exactly one Season, whose Rounds feed that Season's Standings and its Players' Player Indexes.

Round: One Player's play of one course on one date, casual or within an Event. A Round's course and date follow its Event; its tee starts as the Event's and is the Player's to change.

Complete Round: A Round with strokes recorded on all 18 holes. Only Complete Rounds count toward Player Indexes, Tournament Skins and Tournament Ranking.

Match: An Event created by one Player, its creator, holding the Rounds of the Players in it. Its format caps its Rounds: Singles at 2, Three-Ball at 3, and Four-Ball needs exactly 4. Only its creator or a Platform Admin may change or delete it.

Match Team: One of the two sides in a Four-Ball Match, each holding two of its Rounds. Avoid: pair, side

Season: A numbered, Club-owned collection of Tournaments whose results contribute to one Standings table. Numbers begin at 1 and have no calendar meaning; every Tournament belongs to exactly one Season. Avoid: Tournament group, date range

Current Season: A Club's highest-numbered Season. A Club has exactly one once it has any Season, and none before that; it is never repointed at a lower-numbered Season. New Tournaments default to it.

Past Season: Any Season below its Club's highest-numbered Season. Past Seasons remain editable and may receive Tournaments. Avoid: Archived Season

Pairing: A Platform Admin-defined set of up to four Rounds within one Tournament, representing the Players who are playing together. Its Players may enter each other's scores. Avoid: Tournament group (already a rejected synonym for Season), foursome (a Pairing may hold fewer than four)

Scorer: Someone who may enter a Round's per-hole scores and Greenies: the Round's Player, a Platform Admin, the Round's Pairing mates, and, for a Match Round, the Match's other Players and its creator. Avoid: peer scorer, scorekeeper

Course Scorecard Import: The process of turning a course scorecard image into tees and holes for a new or existing course. Avoid: Scorecard reconciliation, scorecard sync

Round Scorecard Import: A process for turning an image of a played scorecard into per-hole scores for existing rounds. Avoid: Round Scorecard Upload (when referring to the full process rather than image transfer)

Placeholder Tee: An unidentified tee retained to preserve its association with historical rounds or tournaments. During an existing-course import, it is explicitly mapped to an imported tee or kept unchanged. Avoid: Unknown tee, temporary tee

Handicap

Score Differential: A single prior round's scoring result, adjusted for course difficulty. The raw input to a Player Index.

Player Index: A Player's handicap index within one Club. For a Tournament Round, computed as the average of the best 2 of their last 4 Score Differentials from the Player's Complete Tournament Rounds in that Club; a Match Round instead carries a hand-entered Player Index Override. Avoid: handicap index, GHIN

Player Index Override: A Player Index entered by hand on a Match Round — used for casual match play instead of a computed one. Only Match Rounds may carry one. Scaled by course slope into a Course Handicap like any Player Index; it is not applied to net strokes directly. Avoid: handicap index override, playing handicap override

Course Handicap: A Player Index scaled to one course's slope — the strokes received on that course.

Playing Handicap: The Course Handicap applied to a Round's net strokes, set by its Event: a Tournament Round's comes from its computed Player Index (scratch until it has 2 prior Rounds); a Match Round's from its Player Index Override (scratch if none); a casual Round has none. Avoid: tournament handicap

Match scoring

Match Play: A per-hole game in which the unique lowest net team score wins the hole. Singles and Three-Ball use 100% relative Playing Handicaps; Four-Ball uses 90% relative Playing Handicaps.

Greenie: A closest-to-the-pin result on a par 3, recorded as the distance from the hole. Each Greenie recorded in a Tournament earns Standings points by distance tier, whether or not it is the closest on its hole. Avoid: Closie, CTP

Match Skins: A Match's per-hole game using relative Playing Handicaps. A unique low net score wins the hole; tied completed holes carry their skins forward until a later unique low net score wins them. Avoid: Skins (alone)

Tournament results

Standings: A Season's points table, built from its Tournaments' results: participation, scoring, Tournament Ranking positions and Greenies. Every Tournament Round earns participation, scoring and Greenie points; only Complete Rounds earn Tournament Ranking position points. Scoring points follow gross strokes, and a hole in one earns ace points only.

Counted Round: One of a Player's highest-scoring Tournament Rounds in a Season, by Standings points, up to a fixed number; only Counted Rounds add to the Player's Standings total. The rest are dropped. Avoid: best rounds, scoring rounds

Tournament Skins: A Tournament's per-hole game across its Complete Rounds. Each Player gets one stroke on holes whose handicap is at most half their Playing Handicap, rounded down. A unique low net score wins the hole; ties are dead, with no carry-over. Tournament Skins earn no Standings points. Avoid: Skins (alone), Field Skins

Tournament Ranking: The order of a Tournament's Complete Rounds, either by Strokes (net) or by Putts, that its Standings position points follow. Tied Rounds do not share points.