Jupyter collaboration extension (#448)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Documentation**
* Reworked Notebook docs to be JupyterLab-centric: renamed headings and
descriptions, updated guidance and visuals, added JupyterLab extensions
and installation checks, clarified Code Playback limitations, and
expanded collaboration/timeline content (including GIF and links).
* **Changelog**
* Added December 12, 2025 entry: support for the Jupyter Collaboration
Extension.

<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: shajason

source/common/develop/ide/editing/jupyter.rst

@@ -1,64 +1,88 @@
 .. meta::
-   :description: Using Jupyter Notebooks for your assignments.
+   :description: Using JupyterLab for your assignments.
 
 .. _jupyter:
 
-Jupyter
-=======
-You can set up your assignment to provide your students with a Jupyter Notebook as the default code editor or to open JupyterLab. More information about `Jupyter Notebook <https://jupyter.org/>`_ and `Jupyter Lab <https://jupyterlab.readthedocs.io/en/latest/>`_.
+JupyterLab
+==========
+You can set up your assignment to provide your students with the `JupyterLab <https://jupyterlab.readthedocs.io/en/latest/>`_ IDE. 
 
-.. Note:: The :ref:`Code Playback <code-playback>` functionality will not work for code your students enter in a Jupyter Notebook.
+.. Note:: 
+   :ref:`Code Playback <code-playback>` does not work with JupyterLab Notebooks. 
+      
+   To view a timeline of events in a notebook, see :ref:`jupyter-collaboration-extension` below. 
 
-Using Jupyter Notebooks in Codio
+Using JupyterLab in Codio
 --------------------------------
-If you plan to use Jupyter Notebook and optionally nbgrader, you must use a stack configured to support them. As these items are often difficult to configure, we recommend that you select the Jupyter Lab stack from our list of Certified Stacks.
+If you plan to use JupyterLab and optionally nbgrader, you must use a stack configured to support them. As these items are often difficult to configure, we recommend that you select the JupyterLab stack from our list of Certified Stacks.
 
-More information about grading using :ref:`nbgrader <notebooks>`.
-
-.. Warning:: :ref:`Pair Programming <group-work>` should not be used for Jupyter Notebook.
+For information about grading notebook assignments, see :ref:`nbgrader <notebooks>`.
 
 .. Note:: Notebook files are only supported in the root (`/home/codio/workspace` or `~/workspace`) folder.
 
-Opening a Jupyter Notebook or JupyterLab
-----------------------------------------
-There are multiple ways to provide your students with access to their Jupyter Notebook.  
+Opening JupyterLab
+------------------
+There are multiple ways to provide your students with access to JupyterLab.  
 
 The following are a few of the possibilities.
 
 - Modify the :ref:`Preview menu <preview>` so that students can access the Jupyter server through the menu and open it in Codio or in a new browser tab.
+   To customize the Preview button, modify this section of the **.codio** file:
+
+   .. code:: ini
+
+      {
+      // Preview button configuration
+         "preview": {
+               "JupyterLab": "https://{{domain3000}}/"
+         }
+      }
 
-      To customize the Preview button, modify this section of the **.codio** file:
 
-      .. code:: ini
+- Use guides to :ref:`create a layout <page>` that automatically opens a pane containing JupyterLab and a particular Notebook file. The example below shows a 2-Panel layout.
+    - Create a **2-Panel Layout**.
+    - Add a tab and select the "JupyterLab" type. 
+    - Enter the name of your file into the **Filename** field or drag it from the file tree.
+    - You can change the :ref:`guide settings <global>` to **Collapsed on Start** and the Jupyter pane will open with the Guides collapsed.
 
-               {
-               // Preview button configuration
-                  "preview": {
-                        "Jupyter Notebook": "https://{{domain3000}}/"
-                  }
-               }
+.. image:: /img/jlablayout.png
+   :alt: Configuring the layout for JupyterLab
 
+If you don't use Guides, consider creating a README.md file with instructions on accessing JupyterLab. When there are no guides, the README.md will auto-open for students. You can tell students to click on the file in the file tree if you haven't configured another way to open it.
 
-- Use guides to :ref:`create a layout <page>` that automatically opens a pane containing JupyterLab or a particular Jupyter NoteBook file. The example below shows a 2-Panel layout. You can also 
+JupyterLab Extensions
+---------------------
 
-      - Create a **2-Panel Layout**.
-      - Add a tab and for type select - "File" or select the "Jupyter Lab" type. 
-      - Enter the name of your file into the **Filename** field or drag it into it from the file tree.
-      - You can change the :ref:`guide settings <global>` to **Collapsed on Start** and the Jupyter pane will open with the Guides collapsed.
+The following two features require JupyterLab. The Codio Certified Jupyter stacks based on Ubuntu 22.04 all come with JupyterLab pre-installed, so you can access these extension features immediately after opening JupyterLab.
 
-   .. image:: /img/jlablayout.png
-      :alt: Configuring the layout for Jupyter Lab
+If you are using a custom stack, you can check if JupyterLab is installed by running ``jupyter --version`` in the terminal. If it is not installed, you will not be able to use these features.
 
-If you don't use Guides, consider creating a README.md file with instructions on accessing the Jupyter Notebook. When there are no guides, the README.md will auto-open for students. You can tell students to click on the file in the file tree if you haven't configured another way to open it.
+Virtual Coach and JupyterLab
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Virtual Coach and Jupyter Notebook
-----------------------------------
 An extension will allow :ref:`Virtual Coach <virtual-coach>` to access the contents of your Jupyter Notebook and detect errors when running Jupyter cells. This extension is already installed in all the Codio Certified Jupyter stacks. You can add the extension if you have your own custom Jupyter stack.
 
-Use the **Tools > Install Software** :ref:`(more information) <box_parts>` menu item to install the **Jupyter Codio extension**. 
+Use the **Tools > Install Software** :ref:`(more information) <box_parts>` menu item to install the **Jupyter Codio Extension**. 
+
+After you have completed installing the software you will need to :ref:`create a new stack <create-stack>` or a :ref:`new stack version <update-stack>` to provide this for your students.
+
+
+.. _jupyter-collaboration-extension:
+
+
+Collaboration and Timeline
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. Important:: You must have JupyterLab 4.4 or greater to use the Jupyter Collaboration Extension.
+
+This extension will allow multiple students to collaborate on a single Jupyter Notebook. You can set up groups using the :ref:`Pair Programming <group-work>` feature to facilitate notebook sharing; note that this extension does not support the Driver/Navigator and Shared Focus functionality (described in the same section).
+
+Use the **Tools > Install Software** :ref:`(more information) <box_parts>` menu item to install the **Jupyter Collaboration Extension**. 
 
 After you have completed installing the software you will need to :ref:`create a new stack <create-stack>` or a :ref:`new stack version <update-stack>` to provide this for your students.
 
-The Codio Jupyter stacks based on Ubuntu 22.04 all utilize JupyterLab, and you should open the file as a JupyterLab (see above) to use all the features of the extension. 
+For more information about the Jupyter Collaboration Extension, see the `official documentation <https://jupyterlab-realtime-collaboration.readthedocs.io/en/latest/>`_. This extension also provides a timeline of events in a Jupyter Notebook; learn more in this `blog post about timeline viewing <https://blog.jupyter.org/exploring-a-documents-timeline-in-jupyterlab-6084f96db263>`_.
 
-You can check if JupyterLab is installed in your stack by entering the command ``jupyter --version`` in the terminal. This command will inform you which Jupyter packages are installed. If JupyterLab is not installed, you should open the Jupyter Notebook as a file.
+.. image:: /img/guides/timeline.gif
+    :alt: An animated GIF showing a review of Jupyter Notebook edits
+    :align: center

source/img/guides/timeline.gif

@@ -13,6 +13,10 @@ We do not report small bug fixes or issues that affect individual users, who we
 `[I]` = Update or improvement
 `[F]` = New feature
 
+**December 2025**
+
+- `[I] [12th]`: Added support for the :ref:`Jupyter Collaboration Extension<jupyter>`.
+
 **November 2025**
 
 - `[F] [28th]`: Added :ref:`Prompt Management <prompt-management>` for organizations.