From 2b5c5f8707feaa9906c85b44dc65602826b861a7 Mon Sep 17 00:00:00 2001
From: stuebinm
Date: Wed, 14 Sep 2022 21:56:34 +0200
Subject: update glossary

---
 GLOSSARY.org | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/GLOSSARY.org b/GLOSSARY.org
index 3334c29..38cda75 100644
--- a/GLOSSARY.org
+++ b/GLOSSARY.org
@@ -2,8 +2,8 @@
 
 This is meant to give a rough overview of (train-related) terms used in this
 code; both for others as a reference and for me so I can remember to use them
-in a (somewhat) consistent way, since they are somewhat arbitrary (though I've
-tried to stick close to the terminology used in GTFS).
+in a (somewhat) consistent way, since they are somewhat arbitrary. I've tried
+to remain at least broadly close to the terminology used by GTFS.
 
 * Terms
 ** (Calendar-)Date / Day
@@ -11,8 +11,11 @@ A single, unique day (e.g. 1970-01-01). Usually used to indicate if a /trip/
 is running on that day or not.
 
 ** Time (of Day)
-Time on a given day, given in minutes since midnight. Trips going across
-midnight simply count minutes up from the previous day.
+Time on a given day, given in seconds (though often displayed as minutes)
+since midnight. If a trip crosses midnight it is treated as if it took place
+entirely on the previous day, and times simply count up beyond the total
+number of seconds in a day (note that that's a timezone-series dependent
+number).
 
 ** Trip (don't confuse with Train)
 Used as in GTFS: a trip is a defined sequence of /stops/, referred to by a
@@ -22,7 +25,7 @@ Always has an associated /shape/.
 (might match your intuition for "train line")
 
 ** Stop
-A /station/ with associated arrival/departure /time/
+A /station/ with associated arrival/departure /time/.
 
 ** Station
 A train station. Tracktrain refers to each by an ID, and hopefully knows
-- 
cgit v1.2.3