Skip to content
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

Merged
merged 2 commits into from
Sep 12, 2024
Merged

Conversation

vpaturet
Copy link
Contributor

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

@vpaturet vpaturet self-assigned this Aug 27, 2024
@vpaturet vpaturet marked this pull request as ready for review August 27, 2024 10:08
@vpaturet vpaturet requested a review from a team as a code owner August 27, 2024 10:08
@vpaturet vpaturet requested a review from t2gran August 27, 2024 10:09
/**
* 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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Frequency based trips?

Copy link
Contributor Author

@vpaturet vpaturet Aug 30, 2024

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.

Copy link
Member

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.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done

Copy link

codecov bot commented Sep 9, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 69.74%. Comparing base (8164d41) to head (809290f).
Report is 123 commits behind head on dev-2.x.

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.
📢 Have feedback on the report? Share it here.

@optionsome optionsome requested review from optionsome and removed request for t2gran September 10, 2024 09:43
@vpaturet vpaturet merged commit e9f847d into opentripplanner:dev-2.x Sep 12, 2024
5 checks passed
t2gran pushed a commit that referenced this pull request Sep 12, 2024
@t2gran t2gran added this to the 2.6 milestone Sep 18, 2024
@t2gran t2gran deleted the add_javadoc_for_trip branch October 9, 2024 21:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants