unpinning JupyterLab 1 from instructions

Author: nicolaskruchten

README.md

@@ -112,44 +112,27 @@ For use in JupyterLab, install the `jupyterlab` and `ipywidgets`
 packages using pip...
 
 ```
-pip install jupyterlab==1.2 "ipywidgets==7.5"
+pip install jupyterlab "ipywidgets=7.5"
 ```
 
 or conda.
 
 ```
-conda install jupyterlab=1.2
-conda install "ipywidgets=7.5"
+conda install jupyterlab "ipywidgets=7.5"
 ```
 
 Then run the following commands to install the required JupyterLab extensions (note that this will require [`node`](https://nodejs.org/) to be installed):
 
 ```
-# Avoid "JavaScript heap out of memory" errors during extension installation
-# (OS X/Linux)
-export NODE_OPTIONS=--max-old-space-size=4096
-# (Windows)
-set NODE_OPTIONS=--max-old-space-size=4096
+# Basic JupyterLab renderer support
+jupyter labextension install jupyterlab-plotly@4.7.0
 
-# Jupyter widgets extension
-jupyter labextension install @jupyter-widgets/jupyterlab-manager@1.1 --no-build
-
-# FigureWidget support
-jupyter labextension install plotlywidget@4.7.0 --no-build
-
-# and jupyterlab renderer support
-jupyter labextension install jupyterlab-plotly@4.7.0 --no-build
-
-# Build extensions (must be done to activate extensions since --no-build is used above)
-jupyter lab build
-
-# Unset NODE_OPTIONS environment variable
-# (OS X/Linux)
-unset NODE_OPTIONS
-# (Windows)
-set NODE_OPTIONS=
+# OPTIONAL: Jupyter widgets extension for FigureWidget support
+jupyter labextension install @jupyter-widgets/jupyterlab-manager plotlywidget@4.7.0
 ```
 
+Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.
+
 ### Static Image Export
 
 plotly.py supports static image export using the `to_image` and `write_image`

doc/python/getting-started.md

@@ -134,29 +134,11 @@ $ conda install "ipywidgets=7.5"
 Then run the following commands to install the required JupyterLab extensions (note that this will require [`node`](https://nodejs.org/) to be installed):
 
 ```
-# Avoid "JavaScript heap out of memory" errors during extension installation
-# (OS X/Linux)
-export NODE_OPTIONS=--max-old-space-size=4096
-# (Windows)
-set NODE_OPTIONS=--max-old-space-size=4096
+# JupyterLab renderer support
+jupyter labextension install jupyterlab-plotly@4.7.0
 
-# Jupyter widgets extension
-jupyter labextension install @jupyter-widgets/jupyterlab-manager@1.1 --no-build
-
-# jupyterlab renderer support
-jupyter labextension install jupyterlab-plotly@4.7.0 --no-build
-
-# FigureWidget support
-jupyter labextension install plotlywidget@4.7.0 --no-build
-
-# Build extensions (must be done to activate extensions since --no-build is used above)
-jupyter lab build
-
-# Unset NODE_OPTIONS environment variable
-# (OS X/Linux)
-unset NODE_OPTIONS
-# (Windows)
-set NODE_OPTIONS=
+# OPTIONAL: Jupyter widgets extension
+jupyter labextension install @jupyter-widgets/jupyterlab-manager plotlywidget@4.7.0
 ```
 
 These packages contain everything you need to run JupyterLab...
@@ -175,14 +157,16 @@ fig = go.Figure(data=go.Bar(y=[2, 3, 1]))
 fig.show()
 ```
 
-or using `FigureWidget` objects.
+or using `FigureWidget` objects (if the "OPTIONAL" step above was executed).
 
 ```python
 import plotly.graph_objects as go
 fig = go.FigureWidget(data=go.Bar(y=[2, 3, 1]))
 fig
 ```
 
+Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.
+
 <!-- #region -->
 
 See [_Displaying Figures in Python_](/python/renderers/) for more information on the renderers framework, and see [_Plotly FigureWidget Overview_](/python/figurewidget/) for more information on using `FigureWidget`.

doc/python/troubleshooting.md

@@ -75,14 +75,30 @@ To list your current extensions, run the following command in a terminal shell:
 $ jupyter labextension list
 ```
 
-To uninstall your `plotly` extensions, run the following commands in a terminal shell before reinstalling them by following the instructions in the [Getting Started guide](/python/getting-started):
+To uninstall your Plotly extensions, run the following commands in a terminal shell before reinstalling them by following the instructions in the [Getting Started guide](/python/getting-started):
 
 ```bash
 $ jupyter labextension uninstall jupyterlab-plotly
 $ jupyter labextension uninstall plotlywidget
 ```
 <!-- #endregion -->
 
-```python
+If you run into "out of memory" problems while installing the extensions, try running these commands before running `jupyter labextension install`...
+
+```
+# Avoid "JavaScript heap out of memory" errors during extension installation
+# (OS X/Linux)
+export NODE_OPTIONS=--max-old-space-size=4096
+# (Windows)
+set NODE_OPTIONS=--max-old-space-size=4096
+```
+
+...and these commands afterwards.
 
 ```
+# Unset NODE_OPTIONS environment variable
+# (OS X/Linux)
+unset NODE_OPTIONS
+# (Windows)
+set NODE_OPTIONS=
+```