From 88db344fedd521076b767dd651ab7eaf976213c7 Mon Sep 17 00:00:00 2001 From: Christopher Yamas Date: Tue, 23 Dec 2025 10:42:43 -0500 Subject: [PATCH 1/2] Add CHANGELOG.md establishing v1.0 stable baseline - Created CHANGELOG.md following Keep a Changelog format - Documented v1.0-beta.1 pre-release (2024-01-06) with all core tables - Promoted to v1.0 stable (2025-12-23) with no normative changes - Established baseline for tracking v2.0 normative changes --- CHANGELOG.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 00000000..610b96b5 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,45 @@ +# Changelog + +All notable changes to the TIDES specification will be documented in this file. + +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). + +## [Unreleased] + +## [1.0] - 2025-12-23 + +### Changed + +- Promoted to stable release (no normative changes from v1.0-beta.1) + +### Added + +- CHANGELOG.md to track specification changes + +## [1.0-beta.1] - 2024-01-06 + +### Added + +- Initial pre-release of the TIDES data specification +- **Core Tables:** + - `vehicle_locations` - Timestamped vehicle locations and speeds. + - `passenger_events` - Timestamped passenger-related events, including boardings and alightings. + - `fare_transactions` - Timestamped fare transaction, associated with devices. + - `stop_visits` - Summarized boarding, alighting, arrival, departure, and other events (kneel engaged, ramp deployed, etc.) by trip and stop for each service date. + - `trips_performed` - Trips performed for each service date. + - `station_activities` - Summarized transactions, entries, and exits by stop or station and time period for each service date (for events not associated with a trip). + - `devices` - Measurement devices, such as AVL, APC, and AFC devices, associated with vehicles or stops or stations. + - `train_cars` - Assets that comprise vehicles, such as train cars, with descriptive information. + - `vehicle_train_cars` - Relationships between assets and vehicles. + - `vehicles` - Vehicles, including buses and train consists, with descriptive information. + - `operators` - Personnel who operate vehicles. +- TIDES Data Package Profile for data packaging +- Sample template data package structure +- Validation tools and test scripts +- Documentation site with governance policies +- Change management policy with semantic versioning + +[Unreleased]: https://github.com/TIDES-transit/TIDES/compare/v1.0...HEAD +[1.0]: https://github.com/TIDES-transit/TIDES/compare/v1.0-beta.1...v1.0 +[1.0-beta.1]: https://github.com/TIDES-transit/TIDES/releases/tag/v1.0-beta.1 From 048ea8c0c4f401952c5f8bdfc7abfdbb49a38d73 Mon Sep 17 00:00:00 2001 From: Christopher Yamas Date: Tue, 23 Dec 2025 10:43:24 -0500 Subject: [PATCH 2/2] Updated to allow duplicate headings per version --- .markdownlint.yaml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/.markdownlint.yaml b/.markdownlint.yaml index 71f3b6e9..34151d60 100644 --- a/.markdownlint.yaml +++ b/.markdownlint.yaml @@ -19,3 +19,7 @@ MD033: false # Remove "no emphasis as heading" MD036: false + +# Allow duplicate headings under different parents (needed for CHANGELOG.md) +MD024: + siblings_only: true