edit comment

Author: emilykl

Diff for: plotly/graph_objs/layout/_template.py

@@ -325,9 +325,10 @@ def __init__(self, arg=None, data=None, layout=None, **kwargs):
         _v = arg.pop("data", None)
         _v = data if data is not None else _v
         if _v is not None:
-            # Template.data contains key for deprecated scattermapbox trace
+            # Template.data contains a 'scattermapbox' key, which causes a
+            # go.Scattermapbox trace object to be created during validation.
             # In order to prevent false deprecation warnings from surfacing,
-            # we suppress deprecation warnings for this line only
+            # we suppress deprecation warnings for this line only.
             with warnings.catch_warnings():
                 warnings.filterwarnings("ignore", category=DeprecationWarning)
                 self["data"] = _v