1 files changed, 12 insertions, 7 deletions
diff --git a/platform/darwin/src/MGLMultiPoint.h b/platform/darwin/src/MGLMultiPoint.h
index eaac50af46..31ab5744a3 100644
--- a/platform/darwin/src/MGLMultiPoint.h
+++ b/platform/darwin/src/MGLMultiPoint.h
@@ -8,10 +8,15 @@ NS_ASSUME_NONNULL_BEGIN
 
 /**
  The `MGLMultiPoint` class is an abstract superclass used to define shapes
- composed of multiple vertices. You should not create instances of this class
- directly. Instead, you should create instances of the `MGLPolyline` or
- `MGLPolygon` classes. However, you can use the method and properties of this
- class to access information about the vertices of the line or polygon.
+ composed of multiple vertices.
+ 
+ You do not create instances of this class directly. Instead, you create
+ instances of the `MGLPolyline` or `MGLPolygon` classes. However, you can use
+ the method and properties of this class to access information about the
+ vertices of the line or polygon.
+ 
+ Do not confuse `MGLMultiPoint` with `MGLPointCollection`, which represents a
+ collection of related but disconnected points.
  */
 MGL_EXPORT
 @interface MGLMultiPoint : MGLShape
@@ -57,7 +62,7 @@ MGL_EXPORT
  the map, it is redrawn immediately.
  
  @param coords The array of coordinates to insert into the shape. The data in
-    this array is copied to the shape’s `coordinate` property.
+    this array is copied to the shape’s `coordinates` property.
  @param count The number of items in the `coords` array.
  @param index The zero-based index at which the first coordinate in `coords`
     will appear in the `coordinates` property.
@@ -69,7 +74,7 @@ MGL_EXPORT
  the map, it is redrawn immediately.
  
  @param coords The array of coordinates to add to the shape. The data in this
-    array is copied to the shape’s `coordinate` property.
+    array is copied to the shape’s `coordinates` property.
  @param count The number of items in the `coords` array.
  */
 - (void)appendCoordinates:(const CLLocationCoordinate2D *)coords count:(NSUInteger)count;
@@ -92,7 +97,7 @@ MGL_EXPORT
     being the second vertex, and so on. The `length` field indicates the number
     of vertices to replace.
  @param coords The array of coordinates defining part of the shape. The data in
-    this array is copied to the shape’s `coordinate` property.
+    this array is copied to the shape’s `coordinates` property.
  */
 - (void)replaceCoordinatesInRange:(NSRange)range withCoordinates:(const CLLocationCoordinate2D *)coords;