- commit
- fb360a2bcfa394efb8b5942f90b0dbfdf97cbc3f
- parent
- 2b56cffed2b3e75a6d51be3be8386b8333c3b8e2
- author
- Dami <dami.etoile@gmail.com>
- kind
- docs risk score 0.0 of 3, Jev's estimate
| M | ROADMAP.md | 12 | +----------- |
| M | docs/ | 26 | ++++++++++++++++++++++++++ |
| M | docs/ | 1 | + |
@@ -22,17 +22,6 @@ The grid is Excel's, 1,048,576 x 16,384, and memory is bounded by the
2222 rises in measured steps; see [Bounds of support](docs/contributing/limits.md#what-would-raise-the-bounds).2323 Tables past it are read in place as [linked sources](docs/files/sources.md).2424 25-### 2. A TUI Jupyter for nushell26-27-Notebook tabs are a TUI Jupyter for nushell28-([Notebooks](docs/nushell/notebooks.md)): code and note cells, outputs in29-place, sent to sheets as live regions, and cells highlighted, checked and30-completed by nu as they're written.31-32-| Item | Result | Size |33-|---|---|---|34-| A command's signature and description for the word at the caret, on the context line, through `nu --ide-hover` or `nu --lsp` | Writing a cell without leaving for `help` | S |35-3625 ## Shelved3726 3827 Explored, not scheduled; the fit is still open.@@ -118,6 +107,7 @@ needs cgo.
118107 - Notebook tabs, a TUI Jupyter for nushell: code and note cells with Jupyter's keys, outputs drawn in place and opened full-screen, `$name` between cells, stale marks and a reactive mode, outputs sent to sheets as live regions (`nu.name`), saved up to a cap, and earlier notebook sheets converted on open: [Notebooks](docs/nushell/notebooks.md)119108 - Cells run as streams: a pipeline that never ends (`tail -f`, `watch`) followed live, its rows reaching the output and its sheet as nu prints them: [Notebooks](docs/nushell/notebooks.md#streams)120109 - Code cells highlighted, checked and completed as they're written by nu itself (`--ide-ast`, `--ide-check`, `--ide-complete`), in the background, falling back to 012's own when nu is missing, old, slow or not trusted: [Notebooks](docs/nushell/notebooks.md#writing-a-cell)110+- The word at the caret on the context line: a command's signature and summary (`--ide-hover`), F1 for its whole help and docs page, and a `$name`'s cell and shape: [Notebooks](docs/nushell/notebooks.md#writing-a-cell)121111 - Table and record outputs drawn and worked as 012's own grid: formats by type, fitted and resizable columns, select, copy, sort, filter and find in place, full-screen, charts and pivots on the sheet the output is sent to: [Notebooks](docs/nushell/notebooks.md#outputs-as-grids)122112 123113 **Files**@@ -241,6 +241,7 @@ delete, copy, cut, move, make notes or code, hide or clear outputs.
241241 | Up, Down, Home, End | Move by the lines on screen, wrapped lines too |242242 | Ctrl+A, Ctrl+E | The start, the end of the line |243243 | Tab | Complete the word at the caret: a cell's `$name`, `$selection`, a linked file, then what nu completes there (commands, flags, paths); one completion goes in at once ([Writing a cell](#writing-a-cell)) |244+| F1 | The help of the command at the caret, with its page in nushell's docs ([Writing a cell](#writing-a-cell)) |244245 245246 A terminal without the kitty keyboard protocol sends Shift+Enter and246247 Ctrl+Enter as Enter ([Keys the terminal has to tell@@ -291,6 +292,31 @@ it the context line says what nu said:
291292 292293 Tab asks `nu --ide-complete` too, after the notebook's own names, so it293294 completes flags, subcommands and paths as well as cells and commands.295+296+Once the caret rests on a word, the context line says what it is, so297+writing a cell doesn't mean leaving it for `help`. On a command, `nu298+--ide-hover` gives its signature (its parameters with their types,299+then its flags) and what it does; on a flag, what the flag does. Where300+the line is short, the flags give way first, then the types, then the301+end of the description. A problem at the caret takes the line instead.302+303+304+305+306+F1 opens the command's whole help over the notebook: what it does, a307+link to its page in nushell's docs, its usage, flags, parameters, input308+and output types and examples. Up and Down scroll it, Esc goes back to309+the cell. F1 on a word that isn't a command opens the keyboard shortcuts,310+as it does anywhere else.311+312+313+314+315+On a `$name` another cell binds, the line says the cell and the shape316+of its value as it last ran (`$files: table, 12 rows × 4 columns from317+cell 3`), from the notebook's own outputs without asking nu; on318+`$selection`, a linked file or `$sheet.A1:C9`, what it reads; on a319+variable the cell binds itself with `let`, the type nu gives it.294320 nu doesn't know the variables a notebook binds, so it's asked about the295321 cell with `$name` for each name the cells assign and each linked file,296322 `$selection` and `$sheet` declared before it; a `$sheet.A1:C9` range@@ -189,6 +189,7 @@ on a sheet, `!` starts an entry as any character does.
189189 | Esc | Back to command mode, keeping what was typed |190190 | Shift+Enter, Ctrl+Enter, Alt+Enter | Run, as in command mode |191191 | Enter, Tab | A new line; complete the word at the caret, with what nu completes there ([Writing a cell](../nushell/notebooks.md#writing-a-cell)) |192+| F1 | The help of the nushell command at the caret, with its page in nushell's docs; the shortcuts where there's none |192193 | Up, Down, Home, End, Ctrl+A, Ctrl+E | Move by the lines on screen; the start, the end of the line |193194 | Word keys | As [anywhere text is edited](#entering-data); Ctrl+U deletes to the start of the line, not the cell |194195