1 files changed, 31 insertions, 0 deletions
diff --git a/platform/darwin/src/MGLStyle.h b/platform/darwin/src/MGLStyle.h
index 7b62432d36..fcbd318b18 100644
--- a/platform/darwin/src/MGLStyle.h
+++ b/platform/darwin/src/MGLStyle.h
@@ -52,6 +52,11 @@ FOUNDATION_EXTERN MGL_EXPORT MGLExceptionName const MGLRedundantSourceIdentifier
     `-[MGLMapViewDelegate mapView:didFinishLoadingStyle:]` or
     `-[MGLMapViewDelegate mapViewDidFinishLoadingMap:]` methods as indicators
     that it's safe to modify the map's style.
+ 
+ #### Related examples
+ See the <a href="https://www.mapbox.com/ios-sdk/maps/examples/default-styles/">
+ Default styles</a> example to learn how to initialize an `MGLMapView` object
+ with a Mapbox default style using `MGLStyle`'s class methods.
  */
 MGL_EXPORT
 @interface MGLStyle : NSObject
@@ -177,6 +182,11 @@ MGL_EXPORT
     instance, the raster tile sets included in the style – use the
     `-satelliteStyleURLWithVersion:` method instead. Such details may change
     significantly from version to version.
+ 
+ #### Related example
+ See the <a href="https://www.mapbox.com/ios-sdk/maps/examples/satellite-style/">
+ Satellite styles</a> example to learn how to initialize a map with the Mapbox
+ Satellite style.
  */
 @property (class, nonatomic, readonly) NSURL *satelliteStyleURL;
 
@@ -208,6 +218,11 @@ MGL_EXPORT
     instance, the minimum zoom level that includes roads – use the
     `-satelliteStreetsStyleURLWithVersion:` method instead. Such details may
     change significantly from version to version.
+ 
+ #### Related example
+ See the <a href="https://www.mapbox.com/ios-sdk/maps/examples/satellite-style/">
+ Satellite styles</a> example to learn how to initialize a map with the Mapbox
+ Satellite Streets style.
  */
 @property (class, nonatomic, readonly) NSURL *satelliteStreetsStyleURL;
 
@@ -381,6 +396,11 @@ MGL_EXPORT
 
  @param layer The layer to insert.
  @param sibling An existing layer in the style.
+ 
+ #### Related examples
+ See the <a href="https://www.mapbox.com/ios-sdk/maps/examples/shape-collection/">
+ Add multiple shapes from a single shape source</a> example to learn how to
+ add a layer to your map below an existing layer.
  */
 - (void)insertLayer:(MGLStyleLayer *)layer belowLayer:(MGLStyleLayer *)sibling;
 
@@ -401,6 +421,11 @@ MGL_EXPORT
 
  @param layer The layer to insert.
  @param sibling An existing layer in the style.
+ 
+ #### Related examples
+ See the <a href="https://www.mapbox.com/ios-sdk/maps/examples/image-source/">
+ Add an image</a> example to learn how to add a layer to your map above an
+ existing layer.
  */
 - (void)insertLayer:(MGLStyleLayer *)layer aboveLayer:(MGLStyleLayer *)sibling;
 
@@ -459,6 +484,12 @@ MGL_EXPORT
 
  @param image The image for the name.
  @param name The name of the image to set to the style.
+ 
+ #### Related examples
+ See the <a href="https://www.mapbox.com/ios-sdk/maps/examples/clustering-with-images/">
+ Use images to cluster point data</a> and <a href="https://www.mapbox.com/ios-sdk/maps/examples/clustering/">
+ Cluster point data</a> examples to learn how to add images to your map using
+ an `MGLStyle` object.
  */
 - (void)setImage:(MGLImage *)image forName:(NSString *)name;