Update docs for release

Author: camdecoster

doc/python/hover-text-and-formatting.md

@@ -83,6 +83,24 @@ fig.update_layout(hovermode="x unified")
 fig.show()
 ```
 
+#### Sorting Unified Hover Labels by Value
+
+*New in 6.8*
+
+In `'x unified'` and `'y unified'` hover modes, items in the hover label appear in the order their traces were added to the figure. Set `layout.hoversort` to `"descending"` or `"ascending"` to instead sort the items by the value being shown, which makes it easier to compare traces at a glance.
+
+```python
+import plotly.express as px
+
+df = px.data.stocks()
+
+fig = px.line(df, x="date", y=df.columns[1:], title="layout.hoversort='descending'")
+fig.update_traces(hovertemplate=None)
+fig.update_layout(hovermode="x unified", hoversort="descending")
+
+fig.show()
+```
+
 #### Customize Title in Unified Hover Mode
 
 *New in 6.3*
@@ -221,6 +239,22 @@ fig.update_layout(
 fig.show()
 ```
 
+### Emitting Hover and Click Events Anywhere in the Plot Area
+
+*New in 6.7*
+
+By default, hover and click events are only emitted when the cursor is over a trace. Set `layout.hoveranywhere=True` or `layout.clickanywhere=True` to emit these events anywhere inside the plot area, including over empty space. The events carry the cursor's data coordinates, which is useful when building interactive callbacks (for example, in [Dash](https://dash.plotly.com/)) that need to respond to clicks on locations that don't correspond to a specific data point.
+
+```python
+import plotly.express as px
+
+df = px.data.iris()
+fig = px.scatter(df, x="sepal_width", y="sepal_length", color="species")
+fig.update_layout(hoveranywhere=True, clickanywhere=True)
+
+fig.show()
+```
+
 ### Customizing Hover text with Plotly Express
 
 Plotly Express functions automatically add all the data being plotted (x, y, color etc) to the hover label. Many Plotly Express functions also support configurable hover text. The `hover_data` argument accepts a list of column names to be added to the hover tooltip, or a dictionary for advanced formatting (see the next section). The `hover_name` property controls which column is displayed in bold as the tooltip title.

doc/python/legend.md

@@ -154,6 +154,25 @@ fig.add_shape(
 fig.show()
 ```
 
+##### Per-Slice `legendrank` for Pie Traces
+
+*New in 6.8*
+
+For `pie` traces, `legendrank` also accepts an array so that each slice can be ranked individually. In the example below, the slices appear in the legend in the order specified by `legendrank` (lowest rank first), independent of the order of `values`.
+
+```python
+import plotly.graph_objects as go
+
+fig = go.Figure(
+    go.Pie(
+        labels=["Oxygen", "Hydrogen", "Carbon", "Nitrogen", "Other"],
+        values=[4500, 2500, 1053, 500, 600],
+        legendrank=[3, 1, 2, 5, 4],
+    )
+)
+fig.show()
+```
+
 #### Showing and Hiding the Legend
 
 By default the legend is displayed on Plotly charts with multiple traces, and this can be explicitly set with the `layout.showlegend` attribute.

doc/python/static-image-export.md

@@ -277,6 +277,8 @@ The following settings are available.
 
 `topojson`: Location of the topojson files needed to render choropleth traces. Defaults to a CDN location. If fully offline export is required, set this to a local directory containing the Plotly.js topojson files.
 
+`headers`: *New in 6.8.* A dict of HTTP headers Kaleido sends when fetching external resources during image export (for example, when fetching OpenStreetMap tiles for tile maps). Defaults to `{"X-Requested-With": "plotly.py"}`, which is required to comply with the [OpenStreetMap tile usage policy](https://operations.osmfoundation.org/policies/tiles/). Requires Kaleido v1.3.0 or later.
+
 `mapbox_access_token`: The default Mapbox access token (Kaleido v0 only). Mapbox traces are deprecated. See the [MapLibre Migration](https://plotly.com/python/mapbox-to-maplibre/) page for more details.
 
 ### Set Defaults

doc/python/subplots.md

@@ -156,6 +156,28 @@ fig.update_layout(height=500, width=700,
 fig.show()
 ```
 
+#### Customizing the Subplot Title Font
+
+*New in 6.8*
+
+Use the `font` argument of `make_subplots` to customize the font used for `subplot_titles`, `column_titles`, `row_titles`, `x_title`, and `y_title`. The argument accepts a dict with any of the standard [font attributes](https://plotly.com/python/reference/layout/annotations/#layout-annotations-items-annotation-font) (`family`, `size`, `color`, `weight`, etc.).
+
+```python
+from plotly.subplots import make_subplots
+import plotly.graph_objects as go
+
+fig = make_subplots(
+    rows=1, cols=2,
+    subplot_titles=("Plot 1", "Plot 2"),
+    font=dict(family="Courier New, monospace", size=20, color="RebeccaPurple"),
+)
+
+fig.add_trace(go.Scatter(x=[1, 2, 3], y=[4, 5, 6]), row=1, col=1)
+fig.add_trace(go.Scatter(x=[20, 30, 40], y=[50, 60, 70]), row=1, col=2)
+
+fig.show()
+```
+
 #### Subplots with Annotations
 
 ```python