Merge branch 'doc-prod'

Author: emmanuelle

doc/python/animations.md

@@ -261,18 +261,6 @@ fig_dict = {
 fig_dict["layout"]["xaxis"] = {"range": [30, 85], "title": "Life Expectancy"}
 fig_dict["layout"]["yaxis"] = {"title": "GDP per Capita", "type": "log"}
 fig_dict["layout"]["hovermode"] = "closest"
-fig_dict["layout"]["sliders"] = {
-    "args": [
-        "transition", {
-            "duration": 400,
-            "easing": "cubic-in-out"
-        }
-    ],
-    "initialValue": "1952",
-    "plotlycommand": "animate",
-    "values": years,
-    "visible": True
-}
 fig_dict["layout"]["updatemenus"] = [
     {
         "buttons": [

doc/python/datashader.md

@@ -36,7 +36,7 @@ jupyter:
 
 [datashader](https://datashader.org/) creates rasterized representations of large datasets for easier visualization, with a pipeline approach consisting of several steps: projecting the data on a regular grid, creating a color representation of the grid, etc.
 
-### Passing datashader rasters as a mabox image layer
+### Passing datashader rasters as a mapbox image layer
 
 We visualize here the spatial distribution of taxi rides in New York City. A higher density
 is observed on major avenues. For more details about mapbox charts, see [the mapbox layers tutorial](/python/mapbox-layers). No mapbox token is needed here.

doc/python/legend.md

@@ -159,7 +159,7 @@ fig.add_trace(go.Scatter(
     name="Decreasing"
 ))
 
-fig.update_layout(legend_title='<b> Trend </b>')
+fig.update_layout(legend_title_text='Trend')
 fig.show()
 ```
 

doc/python/sliders.md

@@ -33,8 +33,8 @@ jupyter:
     thumbnail: thumbnail/slider2017.gif
 ---
 
-#### Simple Slider Control
-Sliders can now be used in Plotly to change the data displayed or style of a plot!
+### Simple Slider Control
+Sliders can be used in Plotly to change the data displayed or style of a plot. 
 
 ```python
 import plotly.graph_objects as go
@@ -60,10 +60,11 @@ fig.data[10].visible = True
 steps = []
 for i in range(len(fig.data)):
     step = dict(
-        method="restyle",
-        args=["visible", [False] * len(fig.data)],
+        method="update",
+        args=[{"visible": [False] * len(fig.data)},
+              {"title": "Slider switched to step: " + str(i)}],  # layout attribute
     )
-    step["args"][1][i] = True  # Toggle i'th trace to "visible"
+    step["args"][0]["visible"][i] = True  # Toggle i'th trace to "visible"
     steps.append(step)
 
 sliders = [dict(
@@ -80,5 +81,27 @@ fig.update_layout(
 fig.show()
 ```
 
+#### Methods
+The method determines which [plotly.js function](https://plot.ly/javascript/plotlyjs-function-reference/) will be used to update the chart. Plotly can use several [updatemenu](https://plot.ly/python/reference/#layout-updatemenus-items-updatemenu-buttons-items-button-method) methods to add the slider:
+- `"restyle"`: modify **data** attributes
+- `"relayout"`: modify **layout** attributes
+- `"update"`: modify **data and layout** attributes
+- `"animate"`: start or pause an animation
+
+### Sliders in Plotly Express
+Plotly Express provide sliders, but with implicit animation. The animation can be ommited by removing `updatemenus` in the `layout`:
+
+```python
+import plotly.express as px
+
+df = px.data.gapminder()
+fig = px.scatter(df, x="gdpPercap", y="lifeExp", animation_frame="year", animation_group="country",
+           size="pop", color="continent", hover_name="country",
+           log_x=True, size_max=55, range_x=[100,100000], range_y=[25,90])
+
+fig["layout"].pop("updatemenus") # optional, drop animation buttons
+fig.show()
+```
+
 #### Reference
 Check out https://plotly.com/python/reference/#layout-updatemenus for more information!

doc/python/sunburst-charts.md

@@ -196,7 +196,7 @@ fig.show()
 
 With branchvalues "total", the value of the parent represents the width of its wedge. In the example below, "Enoch" is 4 and "Awan" is 6 and so Enoch's width is 4/6ths of Awans. With branchvalues "remainder", the parent's width is determined by its own value plus those of its children. So, Enoch's width is 4/10ths of Awan's (4 / (6 + 4)).
 
-Note that this means that the sum of the values of the children cannot exceed the value of their parent when branchvalues "total". When branchvalues "relative" (the default), children will not take up all of the space below their parent (unless the parent is the root and it has a value of 0).
+Note that this means that the sum of the values of the children cannot exceed the value of their parent when branchvalues is set to "total". When branchvalues is set to "remainder" (the default), children will not take up all of the space below their parent (unless the parent is the root and it has a value of 0).
 
 ```python
 import plotly.graph_objects as go