Skip to content

Update Positron Notebook Editor docs: alpha to beta#346

Merged
cindyytong merged 2 commits into
mainfrom
worktree-notebook-alpha-to-beta
May 4, 2026
Merged

Update Positron Notebook Editor docs: alpha to beta#346
cindyytong merged 2 commits into
mainfrom
worktree-notebook-alpha-to-beta

Conversation

@cindyytong
Copy link
Copy Markdown
Contributor

@cindyytong cindyytong commented Apr 30, 2026

posit-dev/positron#12520

Summary

  • Update all notebook documentation to reflect the editor's move from alpha to beta
  • Add new sections: Version control, Ghost cell suggestions (Experimental), Customization & Settings
  • Document all notebook-related settings (general, saving, inline data explorer, assistant, ghost cell suggestions)
  • Apply Posit style guide fixes (contractions, callout types, sentence case headings, timeless language)
  • Address PR review feedback: remove bold from pane names, remove Quarto convert language (not shipping), link to Saving settings subsection

Test plan

  • Run quarto preview and verify the Positron Notebook Editor page renders correctly
  • Verify the Jupyter Notebooks page shows "beta" and uses callout-note
  • Verify the Legacy Notebook Editor page shows "beta" without "currently"
  • Check all positron://settings/ links open correctly in Positron
  • Verify the Saving settings link navigates to the correct subsection

🤖 Generated with Claude Code

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 30, 2026

Deploy Preview for positron-posit-co ready!

Name Link
🔨 Latest commit 355461e
🔍 Latest deploy log https://app.netlify.com/projects/positron-posit-co/deploys/69f8d63620946a000820d9b2
😎 Deploy Preview https://deploy-preview-346--positron-posit-co.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Comment thread positron-notebook-editor.qmd Outdated
Comment thread positron-notebook-editor.qmd
Comment thread positron-notebook-editor.qmd
nstrayer
nstrayer previously approved these changes May 1, 2026
Copy link
Copy Markdown
Contributor

@nstrayer nstrayer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good!

Comment thread positron-notebook-editor.qmd
Comment thread jupyter-notebooks.qmd Outdated
Comment thread positron-notebook-editor.qmd Outdated

The Positron Notebook Editor controls what metadata is saved to the notebook file. This makes notebooks more version-control-friendly. By default, cell outputs are saved but execution counts are not. You can adjust this behavior with the [`notebook.save.outputs`](positron://settings/notebook.save.outputs) and [`notebook.save.executionCounts`](positron://settings/notebook.save.executionCounts) settings.

For cleaner diffs, you can convert a Jupyter notebook to a Quarto notebook (`.qmd`) by running the _Quarto: Convert to Quarto Document_ command from the Command Palette. Quarto notebooks store code and markdown as plain text, making them easier to review in pull requests. For more information on Quarto convert see [the Quarto documentation](https://quarto.org/docs/cli/convert.html).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
For cleaner diffs, you can convert a Jupyter notebook to a Quarto notebook (`.qmd`) by running the _Quarto: Convert to Quarto Document_ command from the Command Palette. Quarto notebooks store code and markdown as plain text, making them easier to review in pull requests. For more information on Quarto convert see [the Quarto documentation](https://quarto.org/docs/cli/convert.html).
For cleaner diffs, you can convert a Jupyter notebook to a Quarto notebook (`.qmd`) by running the _Notebook: Convert to .qmd_ command from the Command Palette. Quarto notebooks store code and markdown as plain text, making them easier to review in pull requests. For more information on Quarto convert see [the Quarto documentation](https://quarto.org/docs/cli/convert.html).

Comment thread positron-notebook-editor.qmd Outdated
Comment thread positron-notebook-editor.qmd Outdated
cindyytong and others added 2 commits May 4, 2026 13:22
Reflect the notebook editor's maturity change, add version control
and ghost cell suggestions sections, document all notebook settings,
and apply style guide fixes (contractions, callout types, headings).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Remove bold from pane names (Connections, Variables, Help), remove
Quarto convert language that is not shipping, and link to the Saving
settings subsection instead of listing individual settings inline.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@cindyytong cindyytong force-pushed the worktree-notebook-alpha-to-beta branch from f7c6d21 to 355461e Compare May 4, 2026 17:24
@cindyytong cindyytong merged commit 40dea52 into main May 4, 2026
5 of 6 checks passed
@cindyytong cindyytong deleted the worktree-notebook-alpha-to-beta branch May 4, 2026 17:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants