Skip to content

Commit 59b9411

Browse files
authored
User facing changelog for 7.4 (#7612)
* User facing changelog for 7.4 * add more content
1 parent 9678c18 commit 59b9411

File tree

1 file changed

+98
-43
lines changed

1 file changed

+98
-43
lines changed

CHANGELOG.md

Lines changed: 98 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -12,66 +12,60 @@ upgrading `notebook`.
1212
Use `pip install pip --upgrade` to upgrade pip. Check pip version with
1313
`pip --version`.
1414

15-
## 7.3
16-
17-
Jupyter Notebook 7.3 is based on JupyterLab 4.3, and includes a number of new features, bug fixes, and enhancements for extension developers. This release is compatible with extensions supporting JupyterLab 4.0. Extension authors are recommended to consult the [Extension Migration Guide](https://jupyterlab.readthedocs.io/en/latest/extension/extension_migration.html#jupyterlab-4-2-to-4-3) which lists deprecations and changes to the public API.
18-
19-
Below are a few highlights for this new release. Most of the new features and improvements come from the update to JupyterLab 4.3, although they may not all be supported in Notebook 7.3.
20-
21-
For reference you may have a look at the [JupyterLab 4.3 changelog](https://jupyterlab.readthedocs.io/en/latest/getting_started/changelog.html#v4-3) to learn more.
22-
23-
### Minimap
24-
25-
The virtual scrollbar now acts as a minimap and exposes information on whether a cell:
26-
27-
- is running/scheduled (`[*]`), idle (`[ ]`) or was already run (e.g. `[1]`)
28-
- was modified since it was last executed (“dirty”) - orange background
29-
- has an output that contains an error - red background
30-
- is markdown/code (`[ ]`/`[*]`/`[1]` for code, nothing for markdown)
31-
- how much text/code it contains
15+
## 7.4
3216

33-
![a screenshot showing the notebook minimap](https://raw.githubusercontent.com/jupyterlab/jupyterlab/main/docs/source/getting_started/changelog_assets/4.3-minimap.png)
17+
Jupyter Notebook 7.4 is based on JupyterLab 4.4, and includes a number of new features, bug fixes, and enhancements for extension developers. This release is compatible with extensions supporting JupyterLab 4.0. Extension authors are recommended to consult the [Extension Migration Guide](https://jupyterlab.readthedocs.io/en/latest/extension/extension_migration.html#jupyterlab-4-3-to-4-4) which lists deprecations and changes to the public API.
3418

35-
To enable the minimap, click on the hamburger icon (≡) which appears in the notebook’s toolbar. If you do not see the hamburger icon, go to `Settings → Notebook → Windowing mode` and choose “full”.
19+
Below are a few highlights for this new release. Most of the new features and improvements come from the update to JupyterLab 4.4, although they may not all be supported in Notebook 7.4.
3620

37-
### File browser enhancements
38-
39-
The file browser now:
40-
41-
- supports resizing the columns and remembers the column sizes after reloading JupyterLab
42-
- supports uploading folders by drag-and-drop
43-
- supports navigation with a single click
44-
- adds a file filter collapsed by default (funnel icon)
21+
For reference you may have a look at the [JupyterLab 4.4 changelog](https://jupyterlab.readthedocs.io/en/latest/getting_started/changelog.html#v4-4) to learn more.
4522

46-
![a screenshot showing that it's now possible to resize the file browser columns](https://github.com/user-attachments/assets/b0d9cd0a-2828-43f7-a922-e8b271e5f7fc)
23+
### Code console improvements
4724

48-
In Jupyter Notebook, the single click navigation is enabled by default. If you would like to disable it to get the same experience as in JupyterLab, go to `Settings → File Browser` and make sure "Navigate files and directories with single click" is unchecked.
25+
The code console prompt can now be positioned on the top, left, or right side of the console,
26+
in addition to the default bottom placement. The placement is persisted in the Prompt Cell
27+
Position setting.
4928

50-
### Improved kernel and server interactions
29+
The console toolbar now includes buttons to:
30+
- Execute code
31+
- Restart the kernel
32+
- Clear the cells
33+
- Switch the kernel
5134

52-
The previous release enabled connecting to external kernels, such as those spawned by a third-party application like Blender. In this release the kernel selector dialog was improved to also show the external kernels.
35+
<img alt="The option to change console prompt position is available under the three dots button in the console toolbar, which is the last toolbar button" src="https://github.com/user-attachments/assets/11f5a82a-0dd2-439b-a520-d04c73363bfe" class="jp-screenshot">
5336

54-
The previous release improved the awareness of the kernel/kernel specification distinction by providing both tree and list view in the kernels sidebar panel, but only the tree view featured the kernel identifiers. In this release both the list and tree view show the kernel identifier stub.
37+
Additional settings for console behavior have been added:
38+
- Clear Code Content on Execute (enabled by default) – When disabled, the code submitted for execution remains in the code editor, allowing for further edits.
39+
- Hide Code Input – When enabled, only the execution output is shown in the console.
40+
- Clear Cells on Execute – When enabled, only the last cell is displayed.
5541

56-
A new toolbar button was added in the kernel allowing to shut down unused kernels (kernels with no widget attached).
42+
Toggling all the three new settings transforms the console into an interactive editor
43+
resembling an ephemeral notebook with a single cell.
5744

58-
![a screenshot showing the list view of the kernels in the sidebar](https://github.com/user-attachments/assets/c7f958c5-4054-4b09-8fad-4df6db8c9b58)
45+
<img alt="Toggling all the three new settings transforms the console into a single cell" src="https://github.com/user-attachments/assets/86eb1114-0d60-4379-a370-b538717fc74f" class="jp-screenshot">
5946

60-
### Full Width Notebook
47+
### Settings import and export
6148

62-
It is now possible to configure the notebook to take up the full width of the page via:
49+
Settings can now be exported to `overrides.json` from the Settings Editor,
50+
which can be used to pre-configure defaults in deployments or to restore settings.
6351

64-
- a setting that can be defined by a user via the Settings Editor
65-
- the `View > Enable Full Width Notebook` menu entry
66-
- the command palette, searching for `Enable Full Width Notebook`
52+
<img alt="The Import and Export buttons in the Settings Editor are the first two items in the toolbar panel" src="https://raw.githubusercontent.com/jupyterlab/jupyterlab/main/docs/source/getting_started/changelog_assets/4.4-settings-import-export.png" class="jp-screenshot">
6753

68-
![a screenshot showing how to enable full width notebook via the menu](https://github.com/user-attachments/assets/148b227a-874a-4bb3-a4c6-c7350525ccc4)
54+
### Support for collaboration without `RTC:` drive
6955

70-
This is particularly useful on large displays, or for those who prefer working with a wider notebook.
56+
Real time collaboration in previous versions of JupyterLab and Jupyter Notebook
57+
(which can be enabled by installing jupyter-collaboration package)
58+
was implemented by swapping the default JupyterLab file system
59+
drive to a collaborative drive with the `RTC:` prefix.
60+
This approach was incompatible with multiple extensions.
61+
JupyterLab 4.4 introduces the Content Providers API, which allows the next version of `jupyter-collaboration` to work without changing the drive prefix.
62+
This improves compatibility with extensions that do not support arbitrary drives.
7163

72-
It is also possible to use the JupyterLab interface for a more fully-featured experience, which allows for full-width notebooks too, and offers a "Simple Interface" mode for only showing a single notebook at a time.
64+
### Context menu opt-out
7365

74-
You can open JupyterLab by clicking on `View > Open JupyterLab`.
66+
The context menu, available under right mouse click in browsers, can now be disabled globally
67+
by toggling the `Enable Context Menu` option available in the Command Palette,
68+
or via the JSON Settings Editor in the Application Context Menu.
7569

7670
<!-- <START NEW CHANGELOG ENTRY> -->
7771

@@ -187,6 +181,67 @@ You can open JupyterLab by clicking on `View > Open JupyterLab`.
187181

188182
[@github-actions](https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Agithub-actions+updated%3A2024-12-21..2024-12-21&type=Issues) | [@jtpio](https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Ajtpio+updated%3A2024-12-21..2024-12-21&type=Issues)
189183

184+
## 7.3
185+
186+
Jupyter Notebook 7.3 is based on JupyterLab 4.3, and includes a number of new features, bug fixes, and enhancements for extension developers. This release is compatible with extensions supporting JupyterLab 4.0. Extension authors are recommended to consult the [Extension Migration Guide](https://jupyterlab.readthedocs.io/en/latest/extension/extension_migration.html#jupyterlab-4-2-to-4-3) which lists deprecations and changes to the public API.
187+
188+
Below are a few highlights for this new release. Most of the new features and improvements come from the update to JupyterLab 4.3, although they may not all be supported in Notebook 7.3.
189+
190+
For reference you may have a look at the [JupyterLab 4.3 changelog](https://jupyterlab.readthedocs.io/en/latest/getting_started/changelog.html#v4-3) to learn more.
191+
192+
### Minimap
193+
194+
The virtual scrollbar now acts as a minimap and exposes information on whether a cell:
195+
196+
- is running/scheduled (`[*]`), idle (`[ ]`) or was already run (e.g. `[1]`)
197+
- was modified since it was last executed (“dirty”) - orange background
198+
- has an output that contains an error - red background
199+
- is markdown/code (`[ ]`/`[*]`/`[1]` for code, nothing for markdown)
200+
- how much text/code it contains
201+
202+
![a screenshot showing the notebook minimap](https://raw.githubusercontent.com/jupyterlab/jupyterlab/main/docs/source/getting_started/changelog_assets/4.3-minimap.png)
203+
204+
To enable the minimap, click on the hamburger icon (≡) which appears in the notebook’s toolbar. If you do not see the hamburger icon, go to `Settings → Notebook → Windowing mode` and choose “full”.
205+
206+
### File browser enhancements
207+
208+
The file browser now:
209+
210+
- supports resizing the columns and remembers the column sizes after reloading JupyterLab
211+
- supports uploading folders by drag-and-drop
212+
- supports navigation with a single click
213+
- adds a file filter collapsed by default (funnel icon)
214+
215+
![a screenshot showing that it's now possible to resize the file browser columns](https://github.com/user-attachments/assets/b0d9cd0a-2828-43f7-a922-e8b271e5f7fc)
216+
217+
In Jupyter Notebook, the single click navigation is enabled by default. If you would like to disable it to get the same experience as in JupyterLab, go to `Settings → File Browser` and make sure "Navigate files and directories with single click" is unchecked.
218+
219+
### Improved kernel and server interactions
220+
221+
The previous release enabled connecting to external kernels, such as those spawned by a third-party application like Blender. In this release the kernel selector dialog was improved to also show the external kernels.
222+
223+
The previous release improved the awareness of the kernel/kernel specification distinction by providing both tree and list view in the kernels sidebar panel, but only the tree view featured the kernel identifiers. In this release both the list and tree view show the kernel identifier stub.
224+
225+
A new toolbar button was added in the kernel allowing to shut down unused kernels (kernels with no widget attached).
226+
227+
![a screenshot showing the list view of the kernels in the sidebar](https://github.com/user-attachments/assets/c7f958c5-4054-4b09-8fad-4df6db8c9b58)
228+
229+
### Full Width Notebook
230+
231+
It is now possible to configure the notebook to take up the full width of the page via:
232+
233+
- a setting that can be defined by a user via the Settings Editor
234+
- the `View > Enable Full Width Notebook` menu entry
235+
- the command palette, searching for `Enable Full Width Notebook`
236+
237+
![a screenshot showing how to enable full width notebook via the menu](https://github.com/user-attachments/assets/148b227a-874a-4bb3-a4c6-c7350525ccc4)
238+
239+
This is particularly useful on large displays, or for those who prefer working with a wider notebook.
240+
241+
It is also possible to use the JupyterLab interface for a more fully-featured experience, which allows for full-width notebooks too, and offers a "Simple Interface" mode for only showing a single notebook at a time.
242+
243+
You can open JupyterLab by clicking on `View > Open JupyterLab`.
244+
190245
## 7.3.2
191246

192247
([Full Changelog](https://github.com/jupyter/notebook/compare/@jupyter-notebook/application-extension@7.3.1...7959ba0de553e9c541d2716d76108a8bc0bc2d6c))

0 commit comments

Comments
 (0)