Merge pull request #3047 from jasongrout/updatewidget

Update changelog with instructions for widget maintainers.

Author: jasongrout

.github/workflows/build.yml

@@ -43,7 +43,7 @@ jobs:
           ${{ runner.os }}-yarn-
     - name: Install dependencies
       run: |
-        python -m pip install --pre jupyterlab~=3.0.0rc4
+        python -m pip install jupyterlab~=3.0
         python -m pip install jupyter_packaging
     - name: Build the extension
       run: |

docs/source/changelog.md

@@ -12,6 +12,12 @@ The main change in this release is that installing `ipywidgets` 7.6.0 will now a
 
 This is accomplished with the new python package `jupyterlab_widgets` version 1.0, on which `ipywidgets` 7.6.0 now depends (similar to how `ipywidgets` already depends on the `widgetsnbextension` package to configure ipywidgets for the classic Jupyter Notebook). The `jupyterlab_widgets` Python package is a JupyterLab 3.0 prebuilt extension, meaning that it can be installed into JupyterLab 3.0 without rebuilding JupyterLab and without needing Node.js installed.
 
+### Updates for Widget Maintainers
+
+Custom widget maintainers will need to update their `@jupyter-widgets/base` dependency version to work in JupyterLab 3.0. For example, if you had a dependency on `@jupyter-widgets/base` version `^2 || ^3`, update to `^2 || ^3 || ^4` for your widget to work in classic Jupyter Notebook, JupyterLab 1, JupyterLab 2, and JupyterLab 3. See [#2472](https://github.com/jupyter-widgets/ipywidgets/pull/2472) for background.
+
+Separately from this update of the version of the `@jupyter-widgets/base` dependency version range, you might consider making your widget's JupyterLab extension a prebuilt extension for JupyterLab 3.0. Users will be able to install your JupyterLab 3.0 prebuilt extension without rebuilding JupyterLab or needing Node.js. See the [JupyterLab 3 extension developer documentation](https://jupyterlab.readthedocs.io/en/stable/extension/extension_dev.html) or the new [widget extension cookiecutter](https://github.com/jupyter-widgets/widget-ts-cookiecutter) for more details.
+
 
 7.5
 ---