Update documentation

Author: vpaturet

src/main/java/org/opentripplanner/transit/service/TransitService.java

@@ -186,6 +186,10 @@ List<TripTimeOnDate> stopTimesForPatternAtStop(
 
   GroupOfRoutes getGroupOfRoutesForId(FeedScopedId id);
 
+  /**
+   * Return the timetable for a given trip pattern and date, taking into account real-time updates.
+   * If no real-times update are applied, fall back to scheduled data.
+   */
   @Nullable
   Timetable getTimetableForTripPattern(TripPattern tripPattern, LocalDate serviceDate);
 

src/main/java/org/opentripplanner/updater/vehicle_position/PollingVehiclePositionUpdater.java

@@ -99,8 +99,8 @@ private static TripPattern getPatternIncludingRealtime(
     Trip trip,
     LocalDate sd
   ) {
-    // TODO OTP2 RT_VP a new instance of DefaultTransitService must be created to retrieve
-    // the latest TimetableSnapshot
+    // a new instance of DefaultTransitService must be created to retrieve
+    // the current TimetableSnapshot
     return (new DefaultTransitService(transitModel)).getPatternForTrip(trip, sd);
   }
 }