add deprecation notice

Author: LiamConnors

Diff for: doc/python/filled-area-on-mapbox.md

@@ -137,6 +137,8 @@ fig.show()
 <!-- #region -->
 ### Mapbox Maps
 
+> Mapbox traces are deprecated and may be removed in a future version of Plotly.py. 
+
 The earlier examples using `go.Scattermap` use Maplibre for rendering. These traces were introduced in Plotly.py 5.24 and is now the recommended way to draw filled areas on tile-based maps. There is also a trace that uses Mapbox, called `go.Scattermapbox`.
 
 To use the `Scattermapbox` trace type, in some cases you _may_ need a Mapbox account and a public [Mapbox Access Token](https://www.mapbox.com/studio). See our [Mapbox Map Layers](/python/mapbox-layers/) documentation for more information.

Diff for: doc/python/lines-on-mapbox.md

@@ -129,6 +129,8 @@ fig.show()
 
 ### Mapbox Maps
 
+> Mapbox traces are deprecated and may be removed in a future version of Plotly.py. 
+
 The earlier examples using `px.line_map` and `go.Scattermap` use Maplibre for rendering. These traces were introduced in Plotly.py 5.24 and are now the recommended way to draw lines on tile-based maps. There are also traces that use Mapbox: `px.line_mapbox` and `go.Scattermapbox`
 
 To plot on Mapbox maps with Plotly you _may_ need a Mapbox account and a public [Mapbox Access Token](https://www.mapbox.com/studio). See our [Mapbox Map Layers](/python/mapbox-layers/) documentation for more information.

Diff for: doc/python/mapbox-county-choropleth.md

@@ -220,6 +220,8 @@ fig.show()
 
 ### Mapbox Maps
 
+> Mapbox traces are deprecated and may be removed in a future version of Plotly.py. 
+
 The earlier examples using `px.choropleth_map` and `go.Choroplethmap` use Maplibre for rendering. These traces were introduced in Plotly.py 5.24 and are now the recommended way to create tile-based choropleth maps. There are also choropleth traces that use Mapbox: `px.choropleth_mapbox` and `go.Choroplethmapbox`
 
 To plot on Mapbox maps with Plotly you _may_ need a Mapbox account and a public [Mapbox Access Token](https://www.mapbox.com/studio). See our [Mapbox Map Layers](/python/mapbox-layers/) documentation for more information.

Diff for: doc/python/mapbox-density-heatmaps.md

@@ -70,6 +70,8 @@ fig.show()
 <!-- #region -->
 ### Mapbox Maps
 
+> Mapbox traces are deprecated and may be removed in a future version of Plotly.py. 
+
 The earlier examples using `px.density_mapbox` and `go.Densitymap` use Maplibre for rendering. These traces were introduced in Plotly.py 5.24. These trace types are now the recommended way to make tile-based density heatmaps. There are also traces that use Mapbox: `density_mapbox` and `go.Densitymapbox`.
 
 To use these trace types, in some cases you _may_ need a Mapbox account and a public [Mapbox Access Token](https://www.mapbox.com/studio). See our [Mapbox Map Layers](/python/mapbox-layers/) documentation for more information.
@@ -89,7 +91,6 @@ fig.show()
 
 <!-- #endregion -->
 
-<!-- #region -->
 <!-- #region -->
 #### Stamen Terrain base map (Stadia Maps token needed): density heatmap with `plotly.express`
 
@@ -110,7 +111,6 @@ fig.update_layout(mapbox_accesstoken=token)
 fig.show()
 ```
 
-<!-- #endregion -->
 
 <!-- #endregion -->
 

Diff for: doc/python/mapbox-layers.md

@@ -222,6 +222,8 @@ fig.show()
 <!-- #region -->
 ### Mapbox
 
+> Mapbox traces are deprecated and may be removed in a future version of Plotly.py. 
+
 #### How Layers Work in Mapbox Tile Maps
 
 Mapbox tile maps are composed of various layers, of three different types: