From 04bac1492a3008aadb12bd664942368f09825092 Mon Sep 17 00:00:00 2001
From: Jason Grout <jason@jasongrout.org>
Date: Wed, 6 Jul 2022 18:42:23 +0000
Subject: [PATCH 1/2] Add deprecated description_tooltip for backwards
 compatibility.

This follows up on #2680 to help users transition to this backwards-incompatible change.
---
 docs/source/user_migration_guides.md          |  4 +---
 .../ipywidgets/widgets/widget_description.py  | 22 +++++++++++++++++++
 2 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/docs/source/user_migration_guides.md b/docs/source/user_migration_guides.md
index 556342dc7c..492cf1f3af 100644
--- a/docs/source/user_migration_guides.md
+++ b/docs/source/user_migration_guides.md
@@ -30,12 +30,10 @@ to wrap reads from the widget.
 
 As part of an effort to make it possible to
 [set tooltips for all widgets](https://github.com/jupyter-widgets/ipywidgets/pull/2680),
-the old `description_tooltip` attribute for certain widgets was removed. Now all widgets
+the old `description_tooltip` attribute for certain widgets was deprecated. Now all widgets
 that inherit `DOMWidget` have the attribute `tooltip` instead.
 
 Suggested migration: Search and replace `description_tooltip` to `tooltip`.
-TBD: ipywidgets should add a `description_tooltip` keyword argument to `DescriptionWidget`s, with
-a deprecation warning.
 
 #### Selection Widgets
 
diff --git a/python/ipywidgets/ipywidgets/widgets/widget_description.py b/python/ipywidgets/ipywidgets/widgets/widget_description.py
index b36641f4fa..5b58035028 100644
--- a/python/ipywidgets/ipywidgets/widgets/widget_description.py
+++ b/python/ipywidgets/ipywidgets/widgets/widget_description.py
@@ -9,6 +9,7 @@
 from .widget_style import Style
 from .widget_core import CoreWidget
 from .domwidget import DOMWidget
+import warnings
 
 @register
 class DescriptionStyle(Style, CoreWidget, Widget):
@@ -24,6 +25,13 @@ class DescriptionWidget(DOMWidget, CoreWidget):
     description_allow_html = Bool(False, help="Accept HTML in the description.").tag(sync=True)
     style = InstanceDict(DescriptionStyle, help="Styling customizations").tag(sync=True, **widget_serialization)
 
+    def __init__(self, *args, **kwargs):
+        if 'description_tooltip' in kwargs:
+            warnings.warn("the description_tooltip argument is deprecated, use tooltip instead", DeprecationWarning)
+            kwargs.setdefault('tooltip', kwargs['description_tooltip'])
+            del kwargs['description_tooltip']
+        super().__init__(*args, **kwargs)
+
     def _repr_keys(self):
         for key in super()._repr_keys():
             # Exclude style if it had the default value
@@ -32,3 +40,17 @@ def _repr_keys(self):
                 if repr(value) == '%s()' % value.__class__.__name__:
                     continue
             yield key
+
+    @property
+    def description_tooltip(self):
+        """The tooltip information.
+        .. deprecated :: 8.0.0
+           Use tooltip attribute instead.
+        """
+        warnings.warn(".description_tooltip is deprecated, use .tooltip instead", DeprecationWarning)
+        return self.tooltip
+
+    @description_tooltip.setter
+    def description_tooltip(self, tooltip):
+        warnings.warn(".description_tooltip is deprecated, use .tooltip instead", DeprecationWarning)
+        self.tooltip = tooltip

From c0c152d735479a29a1f1fb4faf85f31e51eb2211 Mon Sep 17 00:00:00 2001
From: Jason Grout <jason@jasongrout.org>
Date: Wed, 6 Jul 2022 18:54:46 +0000
Subject: [PATCH 2/2] Fix user migration guide: widgetsnbextension no longer
 requires notebook.

---
 docs/source/migration_guides.md      | 2 +-
 docs/source/user_migration_guides.md | 9 +++++----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/docs/source/migration_guides.md b/docs/source/migration_guides.md
index 4f335b27bc..2af47659e7 100644
--- a/docs/source/migration_guides.md
+++ b/docs/source/migration_guides.md
@@ -1,7 +1,7 @@
 Migrating custom widget libraries
 =================================
 
-These are migration guides aimed specifically at developers of third-party
+These are migration guides specifically for developers of third-party
 widgets.
 
 Migrating from 7.x to 8.0
diff --git a/docs/source/user_migration_guides.md b/docs/source/user_migration_guides.md
index 492cf1f3af..18147c9dc0 100644
--- a/docs/source/user_migration_guides.md
+++ b/docs/source/user_migration_guides.md
@@ -1,7 +1,7 @@
 Migrating user code
 ===================
 
-These are migration guides aimed specifically at user of ipywidgets.
+These are migration guides specifically for ipywidgets users.
 
 Migrating from 7.x to 8.0
 -------------------------
@@ -85,6 +85,7 @@ attribute `data-jupyter-widgets-cdn` on the HTML manager script tag. See
 
 #### widgetsnbextension
 
-The `widgetsnbextension` package is no longer a dependency of `ipywidgets`. Consequently,
-neither is the `notebook` package. If you need to keep `notebook` and widget support for it
-you will need to ensure they are explicitly stated in any environment bootstrapping.
+The `notebook` package is no longer a dependency of the `widgetsnbextension`
+package (therefore `notebook` is no longer a dependency of `ipywidgets`). If you
+need to install `notebook` with `ipywidgets`, you will need to install
+`notebook` explicitly.