Further improve docs

Author: optionsome

application/src/main/java/org/opentripplanner/apis/transmodel/model/EnumTypes.java

@@ -478,7 +478,7 @@ public class EnumTypes {
       ViaLocationType.VISIT,
       "The location is visited physically by boarding or alighting a transit trip at " +
       "a given stop, or by traveling via requested coordinate location as part of a access, " +
-      "transfer or egress leg. Intermediate stops visited on-board do not count."
+      "transfer, egress or direct segment. Intermediate stops visited on-board do not count."
     )
     .build();
 

application/src/main/java/org/opentripplanner/model/plan/leg/ViaLocationType.java

@@ -6,8 +6,8 @@
 public enum ViaLocationType {
   /**
    * The location is visited physically by boarding or alighting a transit trip at a given stop, or
-   * by traveling via requested coordinate location as part of a access, transfer or egress leg.
-   * Intermediate stops visited on-board do not count.
+   * by traveling via requested coordinate location as part of a access, transfer, egress or direct
+   * segment. Intermediate stops visited on-board do not count.
    */
   VISIT,
   /**

application/src/main/resources/org/opentripplanner/apis/gtfs/schema.graphqls

@@ -796,7 +796,7 @@ type Leg {
   """
   interlineWithPreviousLeg: Boolean
   "Whether the destination of this leg (field `to`) is one of the intermediate places specified in the query."
-  intermediatePlace: Boolean @deprecated(reason : "Not implemented")
+  intermediatePlace: Boolean @deprecated(reason : "Not implemented. Use `viaLocationType` from from/to fields instead.")
   """
   For transit legs, intermediate stops between the Place where the leg
   originates and the Place where the leg ends. For non-transit legs, null.
@@ -3936,8 +3936,8 @@ enum ViaLocationType {
   PASS_THROUGH
   """
   The location is visited physically by boarding or alighting a transit trip at a given stop, or by
-  traveling via requested coordinate location as part of a access, transfer or egress leg.
-  Intermediate stops visited on-board do not count.
+  traveling via requested coordinate location as part of a access, transfer, egress or direct
+  segment. Intermediate stops visited on-board do not count.
   """
   VISIT
 }

application/src/main/resources/org/opentripplanner/apis/transmodel/schema.graphql

@@ -2085,7 +2085,7 @@ enum VertexType {
 enum ViaLocationType {
   "The via stop location must be visited as part of a transit trip as at the boarding stop, the intermediate stop, or the alighting stop."
   passThrough
-  "The location is visited physically by boarding or alighting a transit trip at a given stop, or by traveling via requested coordinate location as part of a access, transfer or egress leg. Intermediate stops visited on-board do not count."
+  "The location is visited physically by boarding or alighting a transit trip at a given stop, or by traveling via requested coordinate location as part of a access, transfer, egress or direct segment. Intermediate stops visited on-board do not count."
   visit
 }