Merge branch 'dev-tooltip' of plotly.js:kb-/plotly.js into dev-tooltip

kb- · kb- · commit 723276c022d2 · 2024-05-20T04:11:56.000+02:00
diff --git a/README.md b/README.md
@@ -4,11 +4,13 @@
 [![circle ci](https://circleci.com/gh/plotly/plotly.js.png?&style=shield&circle-token=1f42a03b242bd969756fc3e53ede204af9b507c0)](https://circleci.com/gh/plotly/plotly.js)
 [![MIT License](https://img.shields.io/badge/License-MIT-brightgreen.svg)](https://github.com/plotly/plotly.js/blob/master/LICENSE)
 
-This branch introduces a tooltip feature and modebar button. It allows to add an annotation to every clicked point.
-When a plot is created with `editable: true`, the tooltips can be dragged around or deleted. 
+This branch introduces a tooltip feature that can be activated by a new modebar button. It allows to add an annotation to every clicked point.
+By default, tooltips contain x and y coordinates. They can be customized to contain any additional data attached to the trace or points, which makes it a powerful tool for data exploration and presentation.
+
+When a plot is created with `editable: true`, the tooltips can be dragged around or deleted interactively. Their text can also be edited.
 To delete a tooltip, click on its text and delete it.
 
-tooltips can be customized with an optional `tooltiptemplate` (possibilities equivalent to [hovertemplate](https://plotly.com/javascript/reference/scatter/#scatter-hovertemplate)) and `tooltip` annotation options (possibilities equivalent to [annotations](https://plotly.com/javascript/text-and-annotations/))
+Tooltips can be customized with an optional `tooltiptemplate` (possibilities equivalent to [hovertemplate](https://plotly.com/javascript/reference/scatter/#scatter-hovertemplate)) and `tooltip` annotation options (possibilities equivalent to [annotations](https://plotly.com/javascript/text-and-annotations/))
 ![image](https://github.com/kb-/plotly.js/assets/2260417/f7258b47-6eb2-4c3c-a3ce-f23899fe57e1)
 
 This update is compatible with Dash when a figure is created with a Dictionary passed to dcc.Graph (see example in *demo* folder), but not yet with Plotly.py (its implementation enforces a limited set of properties).
