Skip to content

Commit 48ad631

Browse files
authored
Add user facing changelog for 7.1 (#7232)
* Add user facing changelog for 7.1 * minor edits
1 parent e8633bd commit 48ad631

File tree

1 file changed

+97
-0
lines changed

1 file changed

+97
-0
lines changed

CHANGELOG.md

+97
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,101 @@ upgrading `notebook`.
1212
Use `pip install pip --upgrade` to upgrade pip. Check pip version with
1313
`pip --version`.
1414

15+
## v7.1
16+
17+
Jupyter Notebook 7.1 is based on JupyterLab 4.1, 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-0-to-4-1) 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.1, although they are not all supported in Notebook 7.1.
20+
21+
For reference you may have a look at the JupyterLab 4.1 changelog to learn more: https://jupyterlab.readthedocs.io/en/latest/getting_started/changelog.html#v4-1
22+
23+
### Diagrams in Markdown
24+
25+
Matching GitHub-Flavoured Markdown, JupyterLab 4.1 now supports [Mermaid](https://github.com/mermaid-js/mermaid) diagrams.
26+
To create a mermaid diagram use the `mermaid` language specifier for a code block in a markdown cell or document, for example:
27+
28+
~~~
29+
```mermaid
30+
flowchart LR
31+
32+
A[Hard] -->|Text| B(Round)
33+
B --> C{Decision}
34+
C -->|One| D[Result 1]
35+
C -->|Two| E[Result 2]
36+
```
37+
~~~
38+
39+
which renders as:
40+
41+
<img alt="Rendered Mermaid diagram going from left to right with modern look; the diagram contains blueish square node with text Hard pointing to round square node with text Round; over the arrow connecting the two nodes there is a word Text; the second node further connects to a rhombus-shaped node with text Decision which then connects to two further nodes, Result 1 and Result 2." src="https://raw.githubusercontent.com/jupyterlab/jupyterlab/main/docs/source/getting_started/changelog_assets/4.1-merimad-diagram.png" class="jp-screenshot">
42+
43+
### Inline completer
44+
45+
JupyterLab now supports completion presented as ghost text in the cell and file editors,
46+
allowing generative AI models to provide multi-line completions. This can now also be leveraged in Jupyter Notebook.
47+
48+
The suggestions are provided by plugins implementing the ``IInlineCompletionProvider`` API;
49+
by default a single provider which uses kernel history is available.
50+
51+
<img alt="In a code cell with `def fac` content a ghost text containing a suggestion representing further code of factorial function is shown; over the code cell there is a floating widget allowing to accept the suggestion and iterate between alternative suggestions" src="https://raw.githubusercontent.com/jupyterlab/jupyterlab/main/docs/source/getting_started/changelog_assets/4.1-inline-completer.png" class="jp-screenshot">
52+
53+
The suggestions can be invoked as-you-type or manually using a configurable shortcut (by default <kbd>Alt</kbd> + <kbd>\\</kbd>).
54+
The default keyboard shortcuts are displayed in the small widget shown when hovering over the ghost suggestion:
55+
- <kbd>Alt</kbd> + <kbd>End</kbd> - accept suggestion
56+
- <kbd>Alt</kbd> + <kbd>[</kbd> - previous suggestion
57+
- <kbd>Alt</kbd> + <kbd>]</kbd> - next suggestion
58+
59+
To enable the inline suggestions based on the kernel history, go to Settings → Inline Completer → History provider → check the "enabled" checkbox.
60+
61+
In addition to the built-in history suggestions,
62+
the [`jupyter-ai`](https://github.com/jupyterlab/jupyter-ai) extension will provide
63+
suggestions from supported models.
64+
65+
Note that the Jupyter AI extension is not yet compatible with Jupyter Notebook 7.
66+
67+
### Keyboard navigation improvements
68+
69+
Numerous improvements to keyboard navigation with focus on accessibility and usability are included in this release:
70+
- the notebook cells now retain focus
71+
- the focus can now be moved beyond the active notebook
72+
- the toolbars can now be navigated using arrow keys
73+
74+
For more details, see [this post on Jupyter Blog](https://blog.jupyter.org/recent-keyboard-navigation-improvements-in-jupyter-4df32f97628d).
75+
76+
### Execution history in notebook
77+
78+
The code from previously executed cells can be used to populate empty cells,
79+
allowing to iterate on code from previous cells or even sessions
80+
(depending on how a specific kernel stores history).
81+
82+
To cycle between history items press <kbd>Alt</kbd> + <kbd>Arrow Up</kbd> and <kbd>Alt</kbd> + <kbd>Arrow Down</kbd>.
83+
84+
To enable execution history, go to Settings → Notebook → check the "Kernel history access" checkbox.
85+
86+
This feature was already available in the console in previous releases; it only works with kernels supporting execution history requests.
87+
To clear the execution history consult the documentation of the kernel you are using (e.g., IPython/ipykernel).
88+
89+
### Error indicator in the table of contents
90+
91+
When a cell fails during execution, an error indicator will be displayed by the corresponding heading,
92+
increasing awareness of the notebook state and enabling users to quickly navigate to the cell which requires attention.
93+
94+
<img alt="Error indicator in the shape of a triangle with exclamation sign (using ⚠ UTF character) shown next to one of the headings in the table of contents panel" src="https://raw.githubusercontent.com/jupyterlab/jupyterlab/main/docs/source/getting_started/changelog_assets/4.1-toc-error-indicator.png" class="jp-screenshot">
95+
96+
### Search improvements
97+
98+
- The search box will now grow automatically to accommodate longer text
99+
- Search in selection can now be toggled using <kbd>Alt</kbd> + <kbd>L</kbd> and automatic search in selection can be configured in settings
100+
- Tooltips with shortcuts were added to the buttons in the search box to improve discoverability of the shortcuts
101+
102+
### Miscellaneous
103+
104+
- The current theme (dark/light) can now be synced with the browser/system preference (Settings menu → Theme → Synchronise with System Settings)
105+
- A blue "read-only" status indicator is now displayed in the toolbar of documents which cannot be saved because their model is read-only.
106+
- Native support for viewing jsonl/ndjson files was added
107+
- Collapsing of breadcrumbs in the File Browser can be disabled in File Browser settings
108+
109+
15110
<!-- <START NEW CHANGELOG ENTRY> -->
16111

17112
## 7.1.0b0
@@ -119,6 +214,8 @@ Use `pip install pip --upgrade` to upgrade pip. Check pip version with
119214

120215
[@Dilip-Jain](https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3ADilip-Jain+updated%3A2023-10-17..2023-10-27&type=Issues) | [@github-actions](https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Agithub-actions+updated%3A2023-10-17..2023-10-27&type=Issues) | [@jayeshsingh9767](https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Ajayeshsingh9767+updated%3A2023-10-17..2023-10-27&type=Issues) | [@jtpio](https://github.com/search?q=repo%3Ajupyter%2Fnotebook+involves%3Ajtpio+updated%3A2023-10-17..2023-10-27&type=Issues)
121216

217+
## v7.0
218+
122219
## 7.0.6
123220

124221
([Full Changelog](https://github.com/jupyter/notebook/compare/@jupyter-notebook/[email protected]))

0 commit comments

Comments
 (0)