Clarify when sourceID is inferred in documentation

Author: ludvigeriksson

docs/BackgroundLayer.md

@@ -6,7 +6,7 @@
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | id | `string` | `none` | `true` | A string that uniquely identifies the source in the style to which it is added. |
-| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined. |
+| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined.<br/>Inferred from parent source only if the layer is a direct child to it. |
 | sourceLayerID | `string` | `none` | `false` | Identifier of the layer within the source identified by the sourceID property from which the receiver obtains the data to style. |
 | aboveLayerID | `string` | `none` | `false` | Inserts a layer above aboveLayerID. |
 | belowLayerID | `string` | `none` | `false` | Inserts a layer below belowLayerID |

docs/CircleLayer.md

@@ -6,7 +6,7 @@
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | id | `string` | `none` | `true` | A string that uniquely identifies the source in the style to which it is added. |
-| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined. |
+| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined.<br/>Inferred from parent source only if the layer is a direct child to it. |
 | sourceLayerID | `string` | `none` | `false` | Identifier of the layer within the source identified by the sourceID property<br/>from which the receiver obtains the data to style. |
 | aboveLayerID | `string` | `none` | `false` | Inserts a layer above aboveLayerID. |
 | belowLayerID | `string` | `none` | `false` | Inserts a layer below belowLayerID |

docs/FillExtrusionLayer.md

@@ -6,7 +6,7 @@
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | id | `string` | `none` | `true` | A string that uniquely identifies the source in the style to which it is added. |
-| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined. |
+| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined.<br/>Inferred from parent source only if the layer is a direct child to it. |
 | sourceLayerID | `string` | `none` | `false` | Identifier of the layer within the source identified by the sourceID property from which the receiver obtains the data to style. |
 | aboveLayerID | `string` | `none` | `false` | Inserts a layer above aboveLayerID. |
 | belowLayerID | `string` | `none` | `false` | Inserts a layer below belowLayerID |

docs/FillLayer.md

@@ -6,7 +6,7 @@
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | id | `string` | `none` | `true` | A string that uniquely identifies the source in the style to which it is added. |
-| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined. |
+| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined.<br/>Inferred from parent source only if the layer is a direct child to it. |
 | sourceLayerID | `string` | `none` | `false` | Identifier of the layer within the source identified by the sourceID property from which the receiver obtains the data to style. |
 | aboveLayerID | `string` | `none` | `false` | Inserts a layer above aboveLayerID. |
 | belowLayerID | `string` | `none` | `false` | Inserts a layer below belowLayerID |

docs/HeatmapLayer.md

@@ -6,7 +6,7 @@
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | id | `string` | `none` | `true` | A string that uniquely identifies the source in the style to which it is added. |
-| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined. |
+| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined.<br/>Inferred from parent source only if the layer is a direct child to it. |
 | sourceLayerID | `string` | `none` | `false` | Identifier of the layer within the source identified by the sourceID property<br/>from which the receiver obtains the data to style. |
 | aboveLayerID | `string` | `none` | `false` | Inserts a layer above aboveLayerID. |
 | belowLayerID | `string` | `none` | `false` | Inserts a layer below belowLayerID |

docs/LineLayer.md

@@ -6,7 +6,7 @@
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | id | `string` | `none` | `true` | A string that uniquely identifies the source in the style to which it is added. |
-| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined. |
+| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined.<br/>Inferred from parent source only if the layer is a direct child to it. |
 | sourceLayerID | `string` | `none` | `false` | Identifier of the layer within the source identified by the sourceID property from which the receiver obtains the data to style. |
 | aboveLayerID | `string` | `none` | `false` | Inserts a layer above aboveLayerID. |
 | belowLayerID | `string` | `none` | `false` | Inserts a layer below belowLayerID |

docs/MarkerView.md

@@ -1,6 +1,6 @@
 <!-- This file was autogenerated from MarkerView.js do not modify -->
 ## <MapboxGL.MarkerView />
-### MarkerView allows you to place an interactive react native marker to the map.<br/><br/>If you have static view, consider using PointAnnotation or SymbolLayer. They'll offer much better performance.<br/><br/>This is based on [MarkerView plugin](https://docs.mapbox.com/android/plugins/overview/markerview/) on Android and PointAnnotation on iOS.
+### MarkerView allows you to place a interactive react native marker to the map.<br/><br/>If you have static view consider using PointAnnotation or SymbolLayer they'll offer much better performance<br/>.<br/>This is based on [MakerView plugin](https://docs.mapbox.com/android/plugins/overview/markerview/) on Android<br/>and PointAnnotation on iOS.
 
 ### props
 | Prop | Type | Default | Required | Description |

docs/RasterLayer.md

@@ -6,7 +6,7 @@
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | id | `string` | `none` | `true` | A string that uniquely identifies the source in the style to which it is added. |
-| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined. |
+| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined.<br/>Inferred from parent source only if the layer is a direct child to it. |
 | sourceLayerID | `string` | `none` | `false` | Identifier of the layer within the source identified by the sourceID property from which the receiver obtains the data to style. |
 | aboveLayerID | `string` | `none` | `false` | Inserts a layer above aboveLayerID. |
 | belowLayerID | `string` | `none` | `false` | Inserts a layer below belowLayerID |

docs/SymbolLayer.md

@@ -6,7 +6,7 @@
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | id | `string` | `none` | `true` | A string that uniquely identifies the source in the style to which it is added. |
-| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined. |
+| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined.<br/>Inferred from parent source only if the layer is a direct child to it. |
 | sourceLayerID | `string` | `none` | `false` | Identifier of the layer within the source identified by the sourceID property from which the receiver obtains the data to style. |
 | aboveLayerID | `string` | `none` | `false` | Inserts a layer above aboveLayerID. |
 | belowLayerID | `string` | `none` | `false` | Inserts a layer below belowLayerID |

docs/docs.json

@@ -16,7 +16,7 @@
         "required": false,
         "type": "string",
         "default": "MapboxGL.StyleSource.DefaultSourceID",
-        "description": "The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined."
+        "description": "The source from which to obtain the data to style.\nIf the source has not yet been added to the current style, the behavior is undefined.\nInferred from parent source only if the layer is a direct child to it."
       },
       {
         "name": "sourceLayerID",
@@ -832,7 +832,7 @@
         "required": false,
         "type": "string",
         "default": "MapboxGL.StyleSource.DefaultSourceID",
-        "description": "The source from which to obtain the data to style.\nIf the source has not yet been added to the current style, the behavior is undefined."
+        "description": "The source from which to obtain the data to style.\nIf the source has not yet been added to the current style, the behavior is undefined.\nInferred from parent source only if the layer is a direct child to it."
       },
       {
         "name": "sourceLayerID",
@@ -1173,7 +1173,7 @@
         "required": false,
         "type": "string",
         "default": "MapboxGL.StyleSource.DefaultSourceID",
-        "description": "The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined."
+        "description": "The source from which to obtain the data to style.\nIf the source has not yet been added to the current style, the behavior is undefined.\nInferred from parent source only if the layer is a direct child to it."
       },
       {
         "name": "sourceLayerID",
@@ -1424,7 +1424,7 @@
         "required": false,
         "type": "string",
         "default": "MapboxGL.StyleSource.DefaultSourceID",
-        "description": "The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined."
+        "description": "The source from which to obtain the data to style.\nIf the source has not yet been added to the current style, the behavior is undefined.\nInferred from parent source only if the layer is a direct child to it."
       },
       {
         "name": "sourceLayerID",
@@ -1684,7 +1684,7 @@
         "required": false,
         "type": "string",
         "default": "MapboxGL.StyleSource.DefaultSourceID",
-        "description": "The source from which to obtain the data to style.\nIf the source has not yet been added to the current style, the behavior is undefined."
+        "description": "The source from which to obtain the data to style.\nIf the source has not yet been added to the current style, the behavior is undefined.\nInferred from parent source only if the layer is a direct child to it."
       },
       {
         "name": "sourceLayerID",
@@ -2083,7 +2083,7 @@
         "required": false,
         "type": "string",
         "default": "MapboxGL.StyleSource.DefaultSourceID",
-        "description": "The source from which to obtain the data to style.\nIf the source has not yet been added to the current style, the behavior is undefined."
+        "description": "The source from which to obtain the data to style.\nIf the source has not yet been added to the current style, the behavior is undefined.\nInferred from parent source only if the layer is a direct child to it."
       },
       {
         "name": "sourceLayerID",
@@ -3313,7 +3313,7 @@
         "required": false,
         "type": "string",
         "default": "MapboxGL.StyleSource.DefaultSourceID",
-        "description": "The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined."
+        "description": "The source from which to obtain the data to style.\nIf the source has not yet been added to the current style, the behavior is undefined.\nInferred from parent source only if the layer is a direct child to it."
       },
       {
         "name": "sourceLayerID",
@@ -3952,7 +3952,7 @@
         "required": false,
         "type": "string",
         "default": "MapboxGL.StyleSource.DefaultSourceID",
-        "description": "The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined."
+        "description": "The source from which to obtain the data to style.\nIf the source has not yet been added to the current style, the behavior is undefined.\nInferred from parent source only if the layer is a direct child to it."
       },
       {
         "name": "sourceLayerID",

javascript/components/BackgroundLayer.js

@@ -21,7 +21,9 @@ class BackgroundLayer extends AbstractLayer {
     id: PropTypes.string.isRequired,
 
     /**
-     * The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined.
+     * The source from which to obtain the data to style.
+     * If the source has not yet been added to the current style, the behavior is undefined.
+     * Inferred from parent source only if the layer is a direct child to it.
      */
     sourceID: PropTypes.string,
 

javascript/components/CircleLayer.js

@@ -26,6 +26,7 @@ class CircleLayer extends AbstractLayer {
     /**
      * The source from which to obtain the data to style.
      * If the source has not yet been added to the current style, the behavior is undefined.
+     * Inferred from parent source only if the layer is a direct child to it.
      */
     sourceID: PropTypes.string,
 

javascript/components/FillExtrusionLayer.js

@@ -24,7 +24,9 @@ class FillExtrusionLayer extends AbstractLayer {
     id: PropTypes.string.isRequired,
 
     /**
-     * The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined.
+     * The source from which to obtain the data to style.
+     * If the source has not yet been added to the current style, the behavior is undefined.
+     * Inferred from parent source only if the layer is a direct child to it.
      */
     sourceID: PropTypes.string,
 

javascript/components/FillLayer.js

@@ -24,7 +24,9 @@ class FillLayer extends AbstractLayer {
     id: PropTypes.string.isRequired,
 
     /**
-     * The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined.
+     * The source from which to obtain the data to style.
+     * If the source has not yet been added to the current style, the behavior is undefined.
+     * Inferred from parent source only if the layer is a direct child to it.
      */
     sourceID: PropTypes.string,
 

javascript/components/HeatmapLayer.js

@@ -26,6 +26,7 @@ class HeatmapLayer extends AbstractLayer {
     /**
      * The source from which to obtain the data to style.
      * If the source has not yet been added to the current style, the behavior is undefined.
+     * Inferred from parent source only if the layer is a direct child to it.
      */
     sourceID: PropTypes.string,
 

javascript/components/LineLayer.js

@@ -26,6 +26,7 @@ class LineLayer extends AbstractLayer {
     /**
      * The source from which to obtain the data to style.
      * If the source has not yet been added to the current style, the behavior is undefined.
+     * Inferred from parent source only if the layer is a direct child to it.
      */
     sourceID: PropTypes.string,
 

javascript/components/RasterLayer.js

@@ -21,7 +21,9 @@ class RasterLayer extends AbstractLayer {
     id: PropTypes.string.isRequired,
 
     /**
-     * The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined.
+     * The source from which to obtain the data to style.
+     * If the source has not yet been added to the current style, the behavior is undefined.
+     * Inferred from parent source only if the layer is a direct child to it.
      */
     sourceID: PropTypes.string,
 

javascript/components/SymbolLayer.js

@@ -24,7 +24,9 @@ class SymbolLayer extends AbstractLayer {
     id: PropTypes.string.isRequired,
 
     /**
-     * The source from which to obtain the data to style. If the source has not yet been added to the current style, the behavior is undefined.
+     * The source from which to obtain the data to style.
+     * If the source has not yet been added to the current style, the behavior is undefined.
+     * Inferred from parent source only if the layer is a direct child to it.
      */
     sourceID: PropTypes.string,