Document maps SDK cap

Author: yaakovschectman

packages/google_maps_flutter/google_maps_flutter_android/android/src/main/java/io/flutter/plugins/googlemaps/Messages.java

@@ -113,7 +113,11 @@ private PlatformJointType(final int index) {
     }
   }
 
-  /** Enumeration of possible types of Cap. */
+  /**
+   * Enumeration of possible types of PlatformCap, corresponding to the subclasses of Cap in the
+   * Google Maps Android SDK. See
+   * https://developers.google.com/maps/documentation/android-sdk/reference/com/google/android/libraries/maps/model/Cap.
+   */
   public enum PlatformCapType {
     BUTT_CAP(0),
     ROUND_CAP(1),
@@ -1832,7 +1836,10 @@ public void setPoints(@NonNull List<PlatformLatLng> setterArg) {
       this.points = setterArg;
     }
 
-    /** The start and end cap data. */
+    /**
+     * The cap at the start and end vertex of a polyline. See
+     * https://developers.google.com/maps/documentation/android-sdk/reference/com/google/android/libraries/maps/model/Cap.
+     */
     private @NonNull PlatformCap startCap;
 
     public @NonNull PlatformCap getStartCap() {
@@ -2111,7 +2118,8 @@ ArrayList<Object> toList() {
   }
 
   /**
-   * Pigeon equivalent of the Cap class.
+   * Pigeon equivalent of Cap from the platform interface.
+   * https://github.com/flutter/packages/blob/main/packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/cap.dart
    *
    * <p>Generated class from Pigeon that represents data sent in messages.
    */

packages/google_maps_flutter/google_maps_flutter_android/lib/src/messages.g.dart

@@ -50,7 +50,9 @@ enum PlatformJointType {
   round,
 }
 
-/// Enumeration of possible types of Cap.
+/// Enumeration of possible types of PlatformCap, corresponding to the
+/// subclasses of Cap in the Google Maps Android SDK.
+/// See https://developers.google.com/maps/documentation/android-sdk/reference/com/google/android/libraries/maps/model/Cap.
 enum PlatformCapType {
   buttCap,
   roundCap,
@@ -471,7 +473,8 @@ class PlatformPolyline {
 
   List<PlatformLatLng?> points;
 
-  /// The start and end cap data.
+  /// The cap at the start and end vertex of a polyline.
+  /// See https://developers.google.com/maps/documentation/android-sdk/reference/com/google/android/libraries/maps/model/Cap.
   PlatformCap startCap;
 
   PlatformCap endCap;
@@ -518,7 +521,8 @@ class PlatformPolyline {
   }
 }
 
-/// Pigeon equivalent of the Cap class.
+/// Pigeon equivalent of Cap from the platform interface.
+/// https://github.com/flutter/packages/blob/main/packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/cap.dart
 class PlatformCap {
   PlatformCap({
     required this.type,

packages/google_maps_flutter/google_maps_flutter_android/pigeons/messages.dart

@@ -218,23 +218,28 @@ class PlatformPolyline {
   final List<Object?> patterns;
   final List<PlatformLatLng?> points;
 
-  /// The start and end cap data.
+  /// The cap at the start and end vertex of a polyline.
+  /// See https://developers.google.com/maps/documentation/android-sdk/reference/com/google/android/libraries/maps/model/Cap.
   final PlatformCap startCap;
   final PlatformCap endCap;
+
   final bool visible;
   final int width;
   final int zIndex;
 }
 
-/// Enumeration of possible types of Cap.
+/// Enumeration of possible types of PlatformCap, corresponding to the
+/// subclasses of Cap in the Google Maps Android SDK.
+/// See https://developers.google.com/maps/documentation/android-sdk/reference/com/google/android/libraries/maps/model/Cap.
 enum PlatformCapType {
   buttCap,
   roundCap,
   squareCap,
   customCap,
 }
 
-/// Pigeon equivalent of the Cap class.
+/// Pigeon equivalent of Cap from the platform interface.
+/// https://github.com/flutter/packages/blob/main/packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/cap.dart
 class PlatformCap {
   PlatformCap({required this.type, this.bitmapDescriptor, this.refWidth});