-
Notifications
You must be signed in to change notification settings - Fork 1k
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.
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
Add Javadoc for Trip #6022
Add Javadoc for Trip #6022
Conversation
/** | ||
* A Trip represents the movement of a public transport vehicle on a given {@link Route}, using a | ||
* given {@link TransitMode}, on a given sequence of stops served at given passing times. | ||
* <p>A Trip can run at most once per service date. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Frequency based trips?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should be rephrased as :
A scheduled Trip can run at most once per service date, while a frequency-based Trip runs several times on a given service date.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This sounds good. If you add this, I will approve.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done
Codecov ReportAll modified and coverable lines are covered by tests ✅
Additional details and impacted files@@ Coverage Diff @@
## dev-2.x #6022 +/- ##
==========================================
Coverage 69.73% 69.74%
- Complexity 17314 17319 +5
==========================================
Files 1960 1960
Lines 74267 74273 +6
Branches 7603 7605 +2
==========================================
+ Hits 51793 51800 +7
+ Misses 19831 19830 -1
Partials 2643 2643 ☔ View full report in Codecov by Sentry. |
Summary
The Javadoc is missing on the Trip class.
This PR attempts to clarify the definition of a Trip and show how Trip interacts with other entities in the model.
Issue
No
Unit tests
No
Documentation
Added Javadoc