Rename duration fields with explicit suffix

[chrisyamas]

Summary

This is a breaking change as it renames three duration fields in stop_visits from *_time to *_duration suffix to clearly distinguish them from timestamp fields like actual_arrival_time.

Resolves #237

Changes

• spec/stop_visits.schema.json renamed fields:
  • ramp_deployed_time --> ramp_deployed_duration
  • kneel_deployed_time --> kneel_deployed_duration
  • lift_deployed_time --> lift_deployed_duration
• Standardized description phrasing to "Duration of time a [device] is deployed, in seconds."
• CHANGELOG.md added BREAKING change entry under [Unreleased]

Reason for this change

The _time suffix creates confusion because the same table uses _time for actual timestamps (e.g., actual_arrival_time, schedule_departure_time). Users shouldn't have to read the description to know whether a field contains a point-in-time or a duration.\

The new _duration suffix makes the field type immediately clear (and aligns with common naming conventions where _time indicates timestamps and _duration indicates elapsed time).

- See related discussion in Issue #237 and Fall 2025 TIDES Issues Working Group notes from December 10.

Review checklist

Per TIDES change management policy, the following must be met before feature branch changes can merge to develop branch:

• All JSON files validate
• Reviewed and approved by 2+ contributors or board members

[github-actions]

Documentation available at: http://tides-transit.github.io/TIDES/feature/issue-237-duration-naming

[jlstpaul]

Also modify samples/template/TIDES/stop_visits.csv

[github-actions]

Data Validation Report

Sample	Status
./samples/template/TIDES	✔️

[chrisyamas]

Also modify samples/template/TIDES/stop_visits.csv

@jlstpaul, I updated samples/template/TIDES/stop_visits.csv to rename ramp_deployed_time to ramp_deployed_duration, kneel_deployed_time to kneel_deployed_duration, and lift_deployed_time to lift_deployed_duration in the sample header. would you be willing to submit a formal GitHub review?

[CTRAN-Sutinen]

Looks good

[jaygordon]

Looks good, thanks!