Update description for top slot (#12937)

* Update MIGRATION_GUIDE_v3.md --------- Co-authored-by: Stepan Kuzmin <[email protected]>
mapbox · Oct 24, 2023 · 09cbc98 · 09cbc98
1 parent 4b3e858
commit 09cbc98
Showing 1 changed file with 3 additions and 1 deletion.
diff --git a/MIGRATION_GUIDE_v3.md b/MIGRATION_GUIDE_v3.md
@@ -117,9 +117,11 @@ Slot | Description
 --- | ---
 `bottom` | Above polygons (land, landuse, water, etc.)
 `middle` | Above lines (roads, etc.) and behind 3D buildings
-`top` | Above all existing layers in the style
+`top` | Above POI labels and behind Place and Transit labels
+not specified | Above all existing layers in the style
 
 Set the preferred `slot` on the `Layer` object before adding it to your map and your layer will be appropriately placed in the Standard style's layer stack.
+If no slot is specified for a custom layer they are placed at the very top of the layer list, providing a location that has highest collision priority compared to all other layers.
 
 ```js
 map.addLayer({