From 008fbb5dda084051e8c5930c37b7aabff819f31f Mon Sep 17 00:00:00 2001 From: Julia Silge Date: Tue, 9 Dec 2025 18:43:06 -0700 Subject: [PATCH 1/5] Hide `description` from page display --- css/theme.scss | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/css/theme.scss b/css/theme.scss index 8d92c985..7df0d344 100644 --- a/css/theme.scss +++ b/css/theme.scss @@ -418,9 +418,9 @@ a.footnote-back { font-size: 1.1rem; } -// Description spacing +// Description - hide from page display but keep in metadata for SEO/social sharing .description { - margin-top: 1.75rem !important; + display: none !important; } // Footer From 6a7beb6c130b96dc0dad33ac24dc3156d943069c Mon Sep 17 00:00:00 2001 From: Julia Silge Date: Tue, 9 Dec 2025 18:43:24 -0700 Subject: [PATCH 2/5] Add description info to Copilot instructions --- .github/copilot-instructions.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 3f934536..4c32d161 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -63,7 +63,8 @@ Follow these exact rules, which are based on our style guide. - Titles/H1s: Use **Title Case** - Other headings: Use **sentence case** -- Do not format documentation titles. Do not italicize or use quotations. +- Do not format documentation titles. Do not italicize or use quotations. +- Add `description` as YAML front matter for each `.qmd` file, to be used as social sharing metadata. ## Formatting Rules From 84e36b2fc2464473d04be0126ace4166d69cf802 Mon Sep 17 00:00:00 2001 From: Julia Silge Date: Tue, 9 Dec 2025 18:43:42 -0700 Subject: [PATCH 3/5] Add descriptions to each page --- 404.qmd | 2 +- about.qmd | 1 + action-bars.qmd | 1 + add-to-path.qmd | 1 + assistant-chat-agents.qmd | 1 + assistant-chat-commands-participants.qmd | 1 + assistant-chat-context.qmd | 1 + assistant-chat-instructions.qmd | 1 + assistant-chat.qmd | 1 + assistant-completions.qmd | 1 + assistant-getting-started.qmd | 1 + assistant-tips.qmd | 1 + assistant-troubleshooting.qmd | 1 + assistant.qmd | 1 + command-palette.qmd | 1 + connections-pane.qmd | 1 + data-explorer-data-grid.qmd | 1 + data-explorer-filter-bar.qmd | 1 + data-explorer-summary-panel.qmd | 1 + data-explorer.qmd | 1 + databot.qmd | 1 + develop-data-apps.qmd | 1 + download.qmd | 1 + extending-connections.qmd | 1 + extension-development.qmd | 1 + extensions.qmd | 1 + faqs.qmd | 1 + feedback.qmd | 1 + folder-templates.qmd | 1 + git.qmd | 1 + guide-python.qmd | 1 + guide-r-air.qmd | 1 + guide-r.qmd | 1 + help-pane.qmd | 1 + install.qmd | 1 + interpreter-startup.qmd | 1 + jupyter-notebooks.qmd | 1 + keyboard-shortcuts.qmd | 1 + layout.qmd | 1 + licensing.qmd | 1 + managing-interpreters.qmd | 1 + migrate-rstudio-compare.qmd | 1 + migrate-rstudio-keybindings.qmd | 1 + migrate-rstudio-rproj.qmd | 1 + migrate-rstudio-settings-and-extensions.qmd | 1 + migrate-rstudio-snippets.qmd | 1 + migrate-rstudio.qmd | 1 + migrate-vscode.qmd | 1 + privacy.qmd | 1 + publish-to-connect.qmd | 1 + python-installations.qmd | 1 + quarto.qmd | 1 + r-installations.qmd | 1 + release-notes.qmd | 1 + remote-ssh.qmd | 1 + reticulate.qmd | 1 + troubleshooting.qmd | 1 + updating.qmd | 1 + variables-pane.qmd | 1 + welcome.qmd | 4 +++- 60 files changed, 62 insertions(+), 2 deletions(-) diff --git a/404.qmd b/404.qmd index 6ef6b3aa..594ef892 100644 --- a/404.qmd +++ b/404.qmd @@ -1,6 +1,6 @@ --- title: "Page Not Found" -format: html +description: "The page you're looking for isn't available. Search Positron documentation or get started with our free data science IDE for Python and R." --- Oops! The page you requested isn't available. Try [searching our documentation](/404.qmd?q=%20&show-results=1) or find out [how to get started](welcome.qmd) with Positron. \ No newline at end of file diff --git a/about.qmd b/about.qmd index dcd67990..674c8f57 100644 --- a/about.qmd +++ b/about.qmd @@ -1,5 +1,6 @@ --- title: "About Positron" +description: "Positron is a free, powerful IDE for data science built on open standards. Supporting Python, R, notebooks, and Quarto, it's designed to make high-quality tools accessible to everyone." --- The goal of Positron is to create an IDE for data science that supports the full scope of modern scientific and data-driven work, across languages, tools, and workflows. We aim to do this by: diff --git a/action-bars.qmd b/action-bars.qmd index 9f956079..8b2d9fdf 100644 --- a/action-bars.qmd +++ b/action-bars.qmd @@ -1,5 +1,6 @@ --- title: "Action Bars" +description: "Discover how Positron's Action Bars put essential functionality at your fingertips with context-aware buttons, menus, and controls throughout the interface." --- Positron uses Action Bars throughout the application to put essential functionality at your fingertips. diff --git a/add-to-path.qmd b/add-to-path.qmd index 5824f8aa..ef90ea75 100644 --- a/add-to-path.qmd +++ b/add-to-path.qmd @@ -1,5 +1,6 @@ --- title: "Launch Positron from a Terminal" +description: "Launch Positron from your terminal by adding it to your PATH. Walk through step-by-step instructions for macOS, Windows, and Linux." --- If Positron is on your PATH, you can launch it from the terminal: diff --git a/assistant-chat-agents.qmd b/assistant-chat-agents.qmd index 8e318abc..4c076fd7 100644 --- a/assistant-chat-agents.qmd +++ b/assistant-chat-agents.qmd @@ -1,5 +1,6 @@ --- title: "Chat Agents" +description: "Customize AI behavior with chat agents in Positron Assistant. Choose from Ask, Edit, Agent, and Plan modes or create custom agents for specific tasks." --- ::: {.callout-note} diff --git a/assistant-chat-commands-participants.qmd b/assistant-chat-commands-participants.qmd index 0de1701d..3dfb16a3 100644 --- a/assistant-chat-commands-participants.qmd +++ b/assistant-chat-commands-participants.qmd @@ -1,5 +1,6 @@ --- title: "Commands & Participants" +description: "Speed up your workflow with slash commands and chat participants in Positron Assistant. Access quick actions and specialized AI help without long prompts." --- ## Slash commands diff --git a/assistant-chat-context.qmd b/assistant-chat-context.qmd index 45d676e8..c4e64166 100644 --- a/assistant-chat-context.qmd +++ b/assistant-chat-context.qmd @@ -1,5 +1,6 @@ --- title: "Context" +description: "Give Positron Assistant context from your data, plots, Console activity, and files. Learn how to attach relevant context for smarter AI assistance." --- Positron Assistant goes beyond reading your code files; it accesses your loaded data, plots, and Console activity by calling tools and executing code in your R or Python interpreter session or running commands in the Terminal. diff --git a/assistant-chat-instructions.qmd b/assistant-chat-instructions.qmd index 19f3517d..a5af21ac 100644 --- a/assistant-chat-instructions.qmd +++ b/assistant-chat-instructions.qmd @@ -1,5 +1,6 @@ --- title: "Custom Instructions" +description: "Tailor Positron Assistant to your project with custom instructions. Set up workspace-specific AI behavior and coding preferences automatically." --- ::: {.callout-note} diff --git a/assistant-chat.qmd b/assistant-chat.qmd index e9ce307b..0b3b0b16 100644 --- a/assistant-chat.qmd +++ b/assistant-chat.qmd @@ -1,5 +1,6 @@ --- title: "Chat" +description: "Use Positron Assistant's chat pane for AI-powered coding help, inline assistance in editors and terminals, and quick Console error fixes." --- Positron Assistant provides multiple ways to interact with AI assistance across your workspace. Whether you use the dedicated chat pane, inline chat within your Editor or Terminal, or quick Console actions for errors, Assistant integrates seamlessly with your development environment. diff --git a/assistant-completions.qmd b/assistant-completions.qmd index 2d0e06f9..257f4e74 100644 --- a/assistant-completions.qmd +++ b/assistant-completions.qmd @@ -1,5 +1,6 @@ --- title: "Completions" +description: "Get AI-powered code suggestions as you type with GitHub Copilot completions. Inline suggestions support faster coding in Python, R, and more." --- Code completions are text suggestions that appear inline as you type in an editor. These suggestions can be lines or blocks of code based on the context of what you're writing. Other names for code completions include inline suggestions, ghost text, or inline completions. diff --git a/assistant-getting-started.qmd b/assistant-getting-started.qmd index 0771e7d9..78d56076 100644 --- a/assistant-getting-started.qmd +++ b/assistant-getting-started.qmd @@ -1,5 +1,6 @@ --- title: "Getting Started" +description: "Set up Positron Assistant with your model provider of choice." listing: - id: chat-features type: custom diff --git a/assistant-tips.qmd b/assistant-tips.qmd index ea71b282..b7a113c2 100644 --- a/assistant-tips.qmd +++ b/assistant-tips.qmd @@ -1,5 +1,6 @@ --- title: "Tips & Glossary" +description: "Learn best practices for using Positron Assistant effectively. Explore tips for better prompts, managing conversations, and understanding key AI assistant terms." --- This guide provides tips for using Positron Assistant effectively, as well as some common terms and definitions in the [Glossary](#glossary) section. diff --git a/assistant-troubleshooting.qmd b/assistant-troubleshooting.qmd index cc1981fc..bfb532c6 100644 --- a/assistant-troubleshooting.qmd +++ b/assistant-troubleshooting.qmd @@ -1,5 +1,6 @@ --- title: "Troubleshooting" +description: "Solve common Positron Assistant issues with troubleshooting guides for unexpected responses, connection problems, and authentication errors." --- If you're having trouble with Positron Assistant, here are some resources and tools to help diagnose the issue and get things working smoothly. diff --git a/assistant.qmd b/assistant.qmd index 0cdcf2ba..51c53acc 100644 --- a/assistant.qmd +++ b/assistant.qmd @@ -1,5 +1,6 @@ --- title: "Positron Assistant" +description: "Positron Assistant is an AI coding assistant built for data science. Get chat support, inline assistance, and code completions with context from your data, plots, and console history." listing: - id: chat-features type: custom diff --git a/command-palette.qmd b/command-palette.qmd index bbec12a7..6c1a4a0f 100644 --- a/command-palette.qmd +++ b/command-palette.qmd @@ -1,5 +1,6 @@ --- title: "Command Palette" +description: "Access any Positron command instantly with the keyboard-driven Command Palette. Find commands, open files, and navigate your project without using menus." --- Positron inherits the Command Palette from VS Code. The Command Palette is a fast and powerful way to interact with Positron without taking your hands off the keyboard. Think of it as a search bar for functionality. Rather than navigating menus, you can quickly find and run commands from a single interface. diff --git a/connections-pane.qmd b/connections-pane.qmd index 10acbe5c..b33750d0 100644 --- a/connections-pane.qmd +++ b/connections-pane.qmd @@ -1,5 +1,6 @@ --- title: "Connections Pane" +description: "Manage database connections and explore schemas in Python and R. Browse tables, columns, and preview data directly in Positron's Data Explorer." --- The Connections Pane allows you to manage and explore database connections for use within your Python and/or R sessions. You can create connections to databases, explore their schemas, and interactively preview database tables. diff --git a/data-explorer-data-grid.qmd b/data-explorer-data-grid.qmd index a7d76874..3f7600ad 100644 --- a/data-explorer-data-grid.qmd +++ b/data-explorer-data-grid.qmd @@ -1,5 +1,6 @@ --- title: "Data Grid" +description: "View millions of rows and columns in Positron's efficient Data Explorer, with real-time updates and support for Pandas, Polars, tibbles, and database connections." --- The data grid is the primary display, with a spreadsheet-like cell-by-cell view. It's intended to scale efficiently to relatively large in-memory datasets, up to millions of rows or columns. diff --git a/data-explorer-filter-bar.qmd b/data-explorer-filter-bar.qmd index 1aebc1b3..9c6e646f 100644 --- a/data-explorer-filter-bar.qmd +++ b/data-explorer-filter-bar.qmd @@ -1,5 +1,6 @@ --- title: "Filter Bar" +description: "Filter and sort data interactively in the Data Explorer. Create filters, convert them to code, and see real-time row counts as you explore datasets." --- The filter bar provides controls to: diff --git a/data-explorer-summary-panel.qmd b/data-explorer-summary-panel.qmd index ec9ffed2..3d3700d9 100644 --- a/data-explorer-summary-panel.qmd +++ b/data-explorer-summary-panel.qmd @@ -1,5 +1,6 @@ --- title: "Summary Panel" +description: "Get instant column statistics and visualizations with Data Explorer's Summary Panel. View histograms, missing data, and detailed stats for every column." --- The summary panel displays a scrollable list of all column names with an icon representing the data type. Each column will have a sparkline histogram or frequency table of the column data. Missing data for the column is displayed as both an inline bar graph and a percentage. diff --git a/data-explorer.qmd b/data-explorer.qmd index f123aed5..0ab8778c 100644 --- a/data-explorer.qmd +++ b/data-explorer.qmd @@ -1,5 +1,6 @@ --- title: "Data Explorer" +description: "Explore dataframes and data files in a spreadsheet-like grid with filtering, sorting, and summary statistics. View CSV, Parquet, and in-memory data interactively." --- The Data Explorer is designed to complement code-first exploration of data, diff --git a/databot.qmd b/databot.qmd index 54c3ec7f..f41f7a85 100644 --- a/databot.qmd +++ b/databot.qmd @@ -1,5 +1,6 @@ --- title: "Databot" +description: "Experimental AI assistant for exploratory data analysis in Python and R. Accelerate insights by letting AI write and execute analysis code for you." --- ::: {.callout-important} diff --git a/develop-data-apps.qmd b/develop-data-apps.qmd index 407c89fc..3b48a985 100644 --- a/develop-data-apps.qmd +++ b/develop-data-apps.qmd @@ -1,5 +1,6 @@ --- title: "Develop Data Apps" +description: "Build and preview Shiny, Streamlit, Dash, FastAPI, and Flask apps in Positron. Launch with one click of the Play button, or use our debugging support." --- Positron provides a simplified method for running interactive data apps via the **Play** button. Instead of running an app from a **Terminal**, you can run supported apps by clicking the **Play** button in Editor Actions. Additionally, you can start a supported app in debug mode through the **Play** button context menu. diff --git a/download.qmd b/download.qmd index 0a384d3b..07e5a23e 100644 --- a/download.qmd +++ b/download.qmd @@ -1,5 +1,6 @@ --- title: "Download Positron" +description: "Download Positron for Windows, macOS, or Linux. Free data science IDE supporting Python and R with automatic updates included." format: html: include-in-header: diff --git a/extending-connections.qmd b/extending-connections.qmd index 4ba48ed6..f29b2490 100644 --- a/extending-connections.qmd +++ b/extending-connections.qmd @@ -1,5 +1,6 @@ --- title: "Extending the Connections Pane" +description: "Extend Positron's Connections Pane with custom connection types. Learn to add new connection providers and integrate with the New Connections modal." format: html --- diff --git a/extension-development.qmd b/extension-development.qmd index d4c08e71..4e44c42b 100644 --- a/extension-development.qmd +++ b/extension-development.qmd @@ -1,5 +1,6 @@ --- title: "Extension Development" +description: "Build VS Code-compatible extensions for Positron. Create custom tools using TypeScript, Node.js, and the @posit-dev/positron npm package." --- Positron is compatible with VS Code extensions so you can create extensions [as you would for VS Code](https://code.visualstudio.com/api/get-started/your-first-extension). You can use Positron to develop your extension and run it in a new **Extension Development Host** window. diff --git a/extensions.qmd b/extensions.qmd index 1620a630..62e07721 100644 --- a/extensions.qmd +++ b/extensions.qmd @@ -1,5 +1,6 @@ --- title: "Extensions" +description: "Customize Positron with extensions from Open VSX. Learn about included extensions, security best practices, and manual installation options." --- Since Positron is built on [Code OSS](https://github.com/microsoft/vscode) (the open-source core of VS Code), you can use VS Code extensions in Positron. Extensions installed for Positron are _separate_ from the extensions you have installed for VS Code, and they won't interfere with each other. diff --git a/faqs.qmd b/faqs.qmd index 1463ba87..6d04966c 100644 --- a/faqs.qmd +++ b/faqs.qmd @@ -1,5 +1,6 @@ --- title: "Frequently Asked Questions" +description: "Get answers to common questions about Positron: supported languages, RStudio differences, enterprise options, and more." --- diff --git a/feedback.qmd b/feedback.qmd index 41766825..5cba240a 100644 --- a/feedback.qmd +++ b/feedback.qmd @@ -1,5 +1,6 @@ --- title: "Feedback and Issues" +description: "Share feedback, report bugs, and contribute to Positron development. Connect with the team through GitHub Discussions and issue tracking." --- ## Giving feedback diff --git a/folder-templates.qmd b/folder-templates.qmd index fc581710..2aed86b6 100644 --- a/folder-templates.qmd +++ b/folder-templates.qmd @@ -1,5 +1,6 @@ --- title: "Folder Templates" +description: "Start new projects with Folder Templates. Automated setup creates environments, version control, and project structure for Python, R, and more." --- The **New Folder from Template** feature helps you start new projects faster. Use this feature when you want to avoid manual setup, or ensure your project includes all recommended files and settings from the start. Instead of running multiple setup commands, you can make a few selections and Positron sets up everything for you automatically. This feature is ideal if you want to: diff --git a/git.qmd b/git.qmd index 6a539098..bc49bec4 100644 --- a/git.qmd +++ b/git.qmd @@ -1,5 +1,6 @@ --- title: Git Version Control +description: "Track changes, collaborate on code, and manage project history with built-in Git integration in Positron." --- Git is a powerful version control system that helps you track changes to your code, collaborate with others, and maintain a history of your project. Positron provides built-in Git integration that works seamlessly with Git repositories. diff --git a/guide-python.qmd b/guide-python.qmd index efc77186..b6a2114d 100644 --- a/guide-python.qmd +++ b/guide-python.qmd @@ -1,5 +1,6 @@ --- title: "Python in Positron" +description: "Complete guide to Python development in Positron. Learn about environment management, IPython magics, formatting with Ruff, and interactive data science features." --- Positron ships with first class support for Python, along with [R](guide-r.qmd). Start with our guide on how Positron [discovers and manages Python installations](python-installations.qmd), then read on for details on working with Python code in Positron. diff --git a/guide-r-air.qmd b/guide-r-air.qmd index 987fa70b..c2a87a34 100644 --- a/guide-r-air.qmd +++ b/guide-r-air.qmd @@ -1,5 +1,6 @@ --- title: "Formatting R code with Air" +description: "Format R code automatically with Air, a fast Rust-based formatter built into Positron. Enforce consistent style conventions for better readability." --- Positron can format R code with [Air](https://posit-dev.github.io/air/), a new R formatter whose creation was largely motivated by Positron. diff --git a/guide-r.qmd b/guide-r.qmd index 698f76c9..155523dd 100644 --- a/guide-r.qmd +++ b/guide-r.qmd @@ -1,5 +1,6 @@ --- title: "Overview" +description: "Master R development in Positron with native language support. Discover settings, keyboard shortcuts, debugging tools, and interactive Console features." --- Positron ships with first class support for R, along with [Python](guide-python.qmd). Start with our guide on how Positron [discovers and manages R installations](r-installations.qmd), then read on for details on working with R code in Positron. diff --git a/help-pane.qmd b/help-pane.qmd index e7c58305..c5147b42 100644 --- a/help-pane.qmd +++ b/help-pane.qmd @@ -1,5 +1,6 @@ --- title: "Help Pane" +description: "Access rich, in-IDE documentation for Python and R with the Help Pane. View function docs, package vignettes, and source code without leaving Positron." --- diff --git a/install.qmd b/install.qmd index db799186..10ecd204 100644 --- a/install.qmd +++ b/install.qmd @@ -1,5 +1,6 @@ --- title: "Install Positron" +description: "Get started with Positron right away. Install the free data science IDE for Python and R, with prerequisites and setup instructions for all platforms." format: html: include-in-header: diff --git a/interpreter-startup.qmd b/interpreter-startup.qmd index a2f91a81..55adc2ef 100644 --- a/interpreter-startup.qmd +++ b/interpreter-startup.qmd @@ -1,5 +1,6 @@ --- title: "Interpreter Startup" +description: "Control how Python and R interpreters start in Positron. Learn about automatic detection and workspace-based interpreter selection." --- ## First run diff --git a/jupyter-notebooks.qmd b/jupyter-notebooks.qmd index a6a1d716..729dc121 100644 --- a/jupyter-notebooks.qmd +++ b/jupyter-notebooks.qmd @@ -1,5 +1,6 @@ --- title: "Jupyter Notebooks" +description: "Work with Jupyter Notebooks in Positron with built-in support for Python and R. No extra dependencies needed as notebooks integrate seamlessly with the IDE." --- ::: {.callout-note} diff --git a/keyboard-shortcuts.qmd b/keyboard-shortcuts.qmd index ceb569ca..38fecf51 100644 --- a/keyboard-shortcuts.qmd +++ b/keyboard-shortcuts.qmd @@ -1,5 +1,6 @@ --- title: "Keyboard Shortcuts" +description: "Master Positron's keyboard shortcuts for running code, navigating panes, and accessing help. Includes custom keybinding options and troubleshooting tips." --- Positron's keyboard shortcuts, with a few exceptions, are a superset of the keyboard shortcuts used by Visual Studio Code. This table lists the shortcuts specifically added for Positron. diff --git a/layout.qmd b/layout.qmd index 38cd0a78..ac15a1d0 100644 --- a/layout.qmd +++ b/layout.qmd @@ -1,5 +1,6 @@ --- title: "Layout" +description: "Customize your Positron workspace with flexible layout options. Choose from presets like Stacked, Side-by-side, Notebook, or Assistant to match your workflow." --- The Positron interface provides a flexible environment for data science that can be tailored to your needs. You can organize tools and outputs into distinct, customizable panes. This lets you tailor your workspace to your workflows in Python, R, and other languages. diff --git a/licensing.qmd b/licensing.qmd index 0d69df8a..cd70807e 100644 --- a/licensing.qmd +++ b/licensing.qmd @@ -1,5 +1,6 @@ --- title: "Licensing" +description: "Positron is licensed under Elastic License 2.0, a source-available license. Free for personal, academic, and commercial use with minimal restrictions." --- Positron is licensed under the Elastic License 2.0, a source-available license. This license makes Positron available for free to everyone to use, build on, and extend for personal, academic, and commercial use. Its primary restriction is that you can't host Positron as a service to third parties without Posit's agreement. This restriction is necessary for us to build a sustainable business around Positron while also offering it free of charge to the community. diff --git a/managing-interpreters.qmd b/managing-interpreters.qmd index fa5f5763..2e87b6fc 100644 --- a/managing-interpreters.qmd +++ b/managing-interpreters.qmd @@ -1,5 +1,6 @@ --- title: "Managing Interpreters" +description: "Manage multiple Python and R interpreter sessions in Positron. Switch between environments, configure startup options, and run multiple sessions simultaneously." --- Positron is designed to support multiple R and Python interpreter sessions. This enables workflows that span multiple environments, and allows you to switch between them easily within a single workspace. Interpreter sessions are managed primarily through the Interpreter picker and Console pane. diff --git a/migrate-rstudio-compare.qmd b/migrate-rstudio-compare.qmd index 7e501077..fa0f50e6 100644 --- a/migrate-rstudio-compare.qmd +++ b/migrate-rstudio-compare.qmd @@ -1,5 +1,6 @@ --- title: "Comparing RStudio and Positron Features" +description: "Compare RStudio and Positron features side-by-side. Understand what's available now, what's coming, and the future of both IDEs." --- ## What is happening to RStudio? diff --git a/migrate-rstudio-keybindings.qmd b/migrate-rstudio-keybindings.qmd index 1544c1d0..59e57494 100644 --- a/migrate-rstudio-keybindings.qmd +++ b/migrate-rstudio-keybindings.qmd @@ -1,5 +1,6 @@ --- title: "RStudio Keybindings" +description: "Keep your RStudio keyboard shortcuts in Positron. Learn which shortcuts work immediately and how to customize keybindings for a familiar workflow." aliases: - rstudio-keybindings.html --- diff --git a/migrate-rstudio-rproj.qmd b/migrate-rstudio-rproj.qmd index 1cafe7b7..500dcb40 100644 --- a/migrate-rstudio-rproj.qmd +++ b/migrate-rstudio-rproj.qmd @@ -1,5 +1,6 @@ --- title: "The Rproj File" +description: "Understand how Positron handles RStudio files and project management. Learn about workspace settings and project organization." aliases: - rstudio-rproj-file.html --- diff --git a/migrate-rstudio-settings-and-extensions.qmd b/migrate-rstudio-settings-and-extensions.qmd index 669a90bb..2f101bda 100644 --- a/migrate-rstudio-settings-and-extensions.qmd +++ b/migrate-rstudio-settings-and-extensions.qmd @@ -1,5 +1,6 @@ --- title: "Settings and Extensions" +description: "Customize Positron to feel familiar to RStudio. Configure user and workspace settings, install extensions, and personalize your data science environment." --- Your Positron experience can be customized through [settings](#settings-for-rstudio-users) at either the user or workspace level and by installing [extensions](#extensions-for-rstudio-users). diff --git a/migrate-rstudio-snippets.qmd b/migrate-rstudio-snippets.qmd index 3aa60afe..33411ee5 100644 --- a/migrate-rstudio-snippets.qmd +++ b/migrate-rstudio-snippets.qmd @@ -1,5 +1,6 @@ --- title: "Creating R snippets" +description: "Create custom R code snippets in Positron. Speed up coding with ready-made templates for loops, functions, and common patterns." aliases: - r-snippets.html - migrate-rstudio-code.html diff --git a/migrate-rstudio.qmd b/migrate-rstudio.qmd index 2c2015ac..981345b0 100644 --- a/migrate-rstudio.qmd +++ b/migrate-rstudio.qmd @@ -1,5 +1,6 @@ --- title: "Overview" +description: "Transition smoothly from RStudio to Positron. Explore our comprehensive migration guide covering keybindings, settings, features, and what to expect as an RStudio user." --- We expect that many existing RStudio users are curious about Positron and whether they should take it for a test drive or even make it their primary IDE. diff --git a/migrate-vscode.qmd b/migrate-vscode.qmd index 95e024c6..b08b1d54 100644 --- a/migrate-vscode.qmd +++ b/migrate-vscode.qmd @@ -1,5 +1,6 @@ --- title: Migrating to Positron from VS Code +description: "Learn how to migrate from VS Code to Positron, including importing settings and extensions. Discover enhanced data science features like the Console, Variables pane, Data Explorer, and native Python and R support." --- This document outlines how to migrate from VS Code to Positron, a data science-focused editor built on Code OSS. It covers importing VS Code settings and extensions, and explains Positron's enhanced data science features like the Console, Variables pane, Data Explorer, and Plots pane. The guide also details Positron's native support for Python and R workflows, including prerequisites and key differences from VS Code extensions. diff --git a/privacy.qmd b/privacy.qmd index 72c527b0..0e2fab09 100644 --- a/privacy.qmd +++ b/privacy.qmd @@ -1,5 +1,6 @@ --- title: "Privacy" +description: "Learn about Positron's privacy practices and data collection. Understand what information is collected, why, and how to opt out of telemetry." --- ## Positron data collection diff --git a/publish-to-connect.qmd b/publish-to-connect.qmd index bf126472..bb8a6dc4 100644 --- a/publish-to-connect.qmd +++ b/publish-to-connect.qmd @@ -1,5 +1,6 @@ --- title: "Publish Your Work" +description: "Deploy reports, apps, and APIs directly from Positron to Posit Connect or Posit Connect Cloud with one click, using the bundled Publisher extension." --- diff --git a/python-installations.qmd b/python-installations.qmd index 93d6cc65..f77a956d 100644 --- a/python-installations.qmd +++ b/python-installations.qmd @@ -1,5 +1,6 @@ --- title: "Discovering Python Installations" +description: "Understand how Positron discovers Python installations. Covers support for uv, pyenv, conda, venv, pipenv, poetry, and more environment managers." --- This guide explains how Python installations are discovered and managed in Positron. diff --git a/quarto.qmd b/quarto.qmd index 668e6f9f..dc33b5b6 100644 --- a/quarto.qmd +++ b/quarto.qmd @@ -1,5 +1,6 @@ --- title: "Quarto" +description: "Create reproducible documents combining narrative and code with Quarto in Positron." --- [Quarto](https://quarto.org/) is an open-source scientific and technical publishing system for creating reproducible documents that combine narrative and executable code. diff --git a/r-installations.qmd b/r-installations.qmd index 77afd2cb..1bb435d2 100644 --- a/r-installations.qmd +++ b/r-installations.qmd @@ -1,5 +1,6 @@ --- title: "Discovering R Installations" +description: "Learn how Positron finds R installations on your system. Covers automatic discovery across macOS, Windows, Linux, and rig-managed installations." --- This guide pertains to how R installations are discovered and show up in the Interpreter picker. diff --git a/release-notes.qmd b/release-notes.qmd index 0193552f..564b26a7 100644 --- a/release-notes.qmd +++ b/release-notes.qmd @@ -1,5 +1,6 @@ --- title: "Release Notes" +description: "View release notes for all Positron versions. Track new features, bug fixes, and improvements across monthly releases." listing: type: table sort: "title desc" diff --git a/remote-ssh.qmd b/remote-ssh.qmd index 09608f1a..56e130a0 100644 --- a/remote-ssh.qmd +++ b/remote-ssh.qmd @@ -1,5 +1,6 @@ --- title: "Remote SSH" +description: "Connect Positron to remote servers via SSH. Run your IDE locally while accessing files, projects, and interpreter sessions on remote machines." --- Positron has support for Remote SSH sessions. This feature allows the Positron IDE's front end (user interface) to run on one machine, while the back end (files, projects, Python and R sessions, etc.) runs on another machine. The two machines communicate using an ordinary secure shell (SSH) connection. diff --git a/reticulate.qmd b/reticulate.qmd index 78273376..74006b48 100644 --- a/reticulate.qmd +++ b/reticulate.qmd @@ -1,5 +1,6 @@ --- title: Reticulate +description: "Use Python from R with reticulate in Positron. Run Python code interactively within your R session with built-in reticulate integration." --- Positron has built-in support for Python interpreters managed by the [reticulate](https://rstudio.github.io/reticulate/) R package. When the reticulate package is installed, you can use the `repl_python()` function to start a Python interpreter session directly within Positron. This allows you to run Python code interactively, exactly the same way as you would in a standard Python interpreter. diff --git a/troubleshooting.qmd b/troubleshooting.qmd index 8bf32c64..1bdd498f 100644 --- a/troubleshooting.qmd +++ b/troubleshooting.qmd @@ -1,5 +1,6 @@ --- title: "Troubleshooting" +description: "Solve common Positron issues with troubleshooting guides for startup problems, extension errors, interpreter issues, and more." --- If you're having trouble with Positron, here are some resources and tools to help troubleshoot and resolve your problems. diff --git a/updating.qmd b/updating.qmd index ccd34dda..0e9d1ada 100644 --- a/updating.qmd +++ b/updating.qmd @@ -1,5 +1,6 @@ --- title: "Updating Positron" +description: "Keep Positron up to date with automatic monthly releases or opt into daily builds. Learn about update settings and Windows package manager options." --- By default, Positron automatically checks for updates from our channel of monthly releases. diff --git a/variables-pane.qmd b/variables-pane.qmd index 7c0daf31..df7ac206 100644 --- a/variables-pane.qmd +++ b/variables-pane.qmd @@ -1,5 +1,6 @@ --- title: "Variables Pane" +description: "View and inspect all variables in your Python or R session. Browse objects, data tables, and connections in a convenient sidebar interface." --- The Variables pane allows you to view the variables in your Python or R session and by default, is located in the Secondary side bar. diff --git a/welcome.qmd b/welcome.qmd index c1b2da46..4440496e 100644 --- a/welcome.qmd +++ b/welcome.qmd @@ -1,6 +1,6 @@ --- title: "Welcome" -description: "Welcome to Positron, the next-generation data science IDE built for Python and R. It combines the power of a full-featured IDE with interactive data science tools for Python and R." +description: "Welcome to Positron, the next-generation data science IDE built for Python and R." anchor-links: false page-layout: full toc: false @@ -36,6 +36,8 @@ listing: --- +Welcome to Positron, the next-generation data science IDE built for Python and R. It combines the power of a full-featured IDE with interactive data science tools for Python and R + ![Execute code and explore data in Positron](images/astropy.png) Interested in Positron for your team? [Learn about enterprise solutions.](https://posit.co/products/ide/positron/?utm_source=positron-docs&utm_medium=features-page) From 540df1c29c81180834eb0bc8b4b07abae037b0ba Mon Sep 17 00:00:00 2001 From: Julia Silge Date: Tue, 9 Dec 2025 18:44:20 -0700 Subject: [PATCH 4/5] Update `_freeze` --- _freeze/download/execute-results/html.json | 4 ++-- _freeze/install/execute-results/html.json | 4 ++-- _freeze/release-notes/execute-results/html.json | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/_freeze/download/execute-results/html.json b/_freeze/download/execute-results/html.json index b3efc53d..8452f417 100644 --- a/_freeze/download/execute-results/html.json +++ b/_freeze/download/execute-results/html.json @@ -1,8 +1,8 @@ { - "hash": "e422c7c6a5573a522df875824b9feddf", + "hash": "f505eecbd998c18a656e5814d795e2d1", "result": { "engine": "knitr", - "markdown": "---\ntitle: \"Download Positron\"\nformat:\n html:\n include-in-header:\n - '_download.html'\n\n---\n\n## Positron on desktop\n\nFind out what you need to know before you [install](install.qmd) Positron, then download the desktop installer for your platform.\n\n::: callout-important\n## Accept license agreement\n\nPlease review [Positron's license agreement](licensing.qmd) and [privacy policy](https://posit.co/about/privacy-policy/). Your acceptance of this license agreement and privacy policy is required as a condition to proceeding with your download or use of the software.\n\n
\n \n \n
\n:::\n\n\n\n::: {.cell .plain id='download-table'}\n::: {.cell-output-display}\n`````{=html}\n\n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n
Platform Download Size SHA-256
Windows 10, 11 x64 (system level install) Positron-2025.12.1-4-Setup-x64.exe 340M 24977b5
Windows 10, 11 x64 (user level install) Positron-2025.12.1-4-UserSetup-x64.exe 340M 9d4eee6
MacOS 11.0+ (universal) Positron-2025.12.1-4-universal.dmg 917M f53d1a7
MacOS 11.0+ (arm64/Apple Silicon) Positron-2025.12.1-4-arm64.dmg 634M 422c197
MacOS 11.0+ (x64/Intel) Positron-2025.12.1-4-x64.dmg 632M 906f545
Debian-based Linux x64 (Ubuntu 20+) Positron-2025.12.1-4-x64.deb 341M 32eac7f
Debian-based Linux arm64 (Ubuntu 20+) Positron-2025.12.1-4-arm64.deb 328M 747d5b5
Red Hat-based Linux x64 (RHEL9) Positron-2025.12.1-4-x64.rpm 386M 5e45f87
Red Hat-based Linux arm64 (RHEL9) Positron-2025.12.1-4-arm64.rpm 372M dfd1a63
\n\n`````\n:::\n:::\n\n
\n\nOnce you install Positron, it will [automatically check for updates moving forward](updating.qmd).\n\n## Positron Pro on Posit Workbench\n\n[Posit Workbench](https://posit.co/products/enterprise/workbench/) 2025.09.0 and later includes support for Positron Pro. To configure and use Positron Pro on Posit Workbench, please see the [Posit Workbench Administration Guide](https://docs.posit.co/ide/server-pro/positron_sessions/) and the [Positron Pro user guide](https://docs.posit.co/ide/server-pro/user/positron/getting-started/).\n\n## Release notes\n\nThe current release of Positron is {{< env RELEASE_VERSION >}}.\n\n### Patch notes\n\nThe 2025.12.1 patch release addresses [this issue](https://github.com/posit-dev/positron/issues/10904), deduplicating Python completions and fixing some situations where Python hover popups and function signature help popups wouldn't appear.\n\n### Release highlights\n\n#### Try our new Python language server options 🐍\n\nOur new release provides both a better default experience for editing Python code, as well as more flexibility for folks who want more control. We changed our Python language server approach so you can install your own extension of choice to provide syntax highlighting and other language server features; we've tested out basedpyright, ty, Pyrefly, and ZubanLS and expect all to work in Positron now. One of our goals is to provide a great \"batteries included\" experience for all users (including those who aren't sure which to choose) so, starting with this release, we now bundle the [Pyrefly](https://open-vsx.org/extension/meta/pyrefly) extension.\n\nWe no longer bundle the Pyright extension because its functionality overlaps with Pyrefly. If you do not want to use Pyrefly, disable that extension. You also will want to uninstall the Python Environments extension if you have it, because its features do not work in Positron.\n\n[Let us know](https://github.com/posit-dev/positron/discussions) how it goes with our new Python language server support!\n\n#### Positron Assistant 🤖\n\nThis release brings several improvements to make Assistant more reliable and easier to troubleshoot. Two new commands help you manage your Assistant configuration:\n\n- _Positron Assistant: Reset State_ lets you start totally fresh when needed.\n- _Positron Assistant: Collect Diagnostics_ generates a diagnostics report to help identify issues. \n \nWe have also improved token efficiency across many tools and introduced preview support for Snowflake Cortex as a language model provider.\n\n#### Run your code with new keyboard shortcuts 💥\n\nThe most upvoted feature in this month's release is a new set of keyboard shortcuts for running code from your document beginning to the current line Ctrl/Cmd+Alt+Home and from the current line to your document end Ctrl/Cmd+Alt+End. If you opt in the RStudio Keymap, these are available as Ctrl/Cmd+Alt+B and Ctrl/Cmd+Alt+E.\n\n
\n\n### Changelog\n\n#### New features\n\n- [[#10104](https://github.com/posit-dev/positron/issues/10104), [#10243](https://github.com/posit-dev/positron/issues/10243), [#10241](https://github.com/posit-dev/positron/issues/10241)] Added new Catalog Explorer support for Snowflake data catalogs. This feature is in preview and can be enabled by opting in to the new [`catalogExplorer.enable`](positron://settings/catalogExplorer.enable) setting.\n- [[#10430](https://github.com/posit-dev/positron/issues/10430)] Added Connections Pane support for Python Databricks SQL Connector.\n- [[#10431](https://github.com/posit-dev/positron/issues/10431)] Added Connections Pane support for Python Google BigQuery.\n- [[#10348](https://github.com/posit-dev/positron/issues/10348), [#10236](https://github.com/posit-dev/positron/issues/10236)] Assistant: improved token efficiency of project tools.\n- [[#10346](https://github.com/posit-dev/positron/issues/10346)] Assistant: added command _Positron Assistant: Reset State_ to reset Assistant state.\n- [[#10344](https://github.com/posit-dev/positron/issues/10344)] Assistant: added command _Positron Assistant: Collect Diagnostics_ to generate a diagnostics report.\n- [[#10179](https://github.com/posit-dev/positron/issues/10179)] Assistant: on Posit Workbench, AWS Bedrock is automatically enabled within Assistant when Managed Credentials are available.\n- [[#9652](https://github.com/posit-dev/positron/issues/9652)] Assistant: the AWS Bedrock provider now gracefully handles credential expiration, and automatically refreshes them with the `aws` CLI tool.\n- [[#9971](https://github.com/posit-dev/positron/issues/9971)] Assistant: added initial support for user-defined model listing.\n- [[#8613](https://github.com/posit-dev/positron/issues/8613)] Assistant: added preview support for Snowflake Cortex language model provider with OAuth managed credentials integration.\n- [[#8334](https://github.com/posit-dev/positron/issues/8334)] Added a new layout preset for an Assistant-centric workflow (in addition to the existing stacked, side-by-side, and notebook layout presets).\n- [[#3731](https://github.com/posit-dev/positron/issues/3731), [#10304](https://github.com/posit-dev/positron/issues/10304)] Python: we now bundle the Pyrefly extension, which gives a much richer Python editing experience, including better syntax highlighting.\n- [[#2318](https://github.com/posit-dev/positron/issues/2318)] R: now apply syntax highlighting to roxygen `@examplesIf` sections.\n- [[#10325](https://github.com/posit-dev/positron/issues/10325)] R: added shim for `rstudioapi::readRStudioPreference()`.\n- [[#7430](https://github.com/posit-dev/positron/issues/7430)] R: allow extensions to contribute F1 \"show help topic\" entries.\n- [[#10645](https://github.com/posit-dev/positron/issues/10645)] R: the syntax highlighting for `T` and `F` now treats them as regular variables (since they are not reserved words or constants in R).\n- [[#8559](https://github.com/posit-dev/positron/issues/8559)] R: Cmd/Ctrl+Enter within roxygen2 `@examples` and `@examplesIf` tags now executes entire R expressions rather than executing one line at a time.\n- [[#4395](https://github.com/posit-dev/positron/issues/4395)] Added new keyboard shortcuts to run code from the document beginning to the current line Ctrl/Cmd+Alt+Home and from the current line to the document end Ctrl/Cmd+Alt+End. If you opt in the RStudio Keymap, these are available as Ctrl/Cmd+Alt+B and Ctrl/Cmd+Alt+E.\n- [[#6479](https://github.com/posit-dev/positron/issues/6479)] Added a new [`workbench.topActionBar.visible`](positron://settings/workbench.topActionBar.visible) setting to control whether the Positron top bar is visible.\n- [[#7054](https://github.com/posit-dev/positron/issues/7054)] Added new command _Plots: Open Plots Gallery in New Window_ to open the whole Plots pane UI in an auxiliary window. You can also pop out the new standalone window from the plots action bar.\n- [[#10329](https://github.com/posit-dev/positron/issues/10329)] Added new setting [`plots.historyPolicy`](positron://settings/plots.historyPolicy) to control when the plot history filmstrip is visible.\n- [[#7747](https://github.com/posit-dev/positron/issues/7747)] Added new button to interrupt a running app (such as Streamlit or FastAPI) from the Viewer pane.\n- [[#10580](https://github.com/posit-dev/positron/issues/10580)] Added new command `positron.executeCodeInConsole` for extensions to execute code for a given language, URI, and position (such as for the Quarto visual editor).\n\n\n#### Bug fixes\n\n- [[#4604](https://github.com/posit-dev/positron/issues/4604)] Console: fixed interrupt of Python console on Windows.\n- [[#10382](https://github.com/posit-dev/positron/issues/10382)] Console: fixed rendering of Python data frames in the console.\n- [[#8303](https://github.com/posit-dev/positron/issues/8303)] Console: fixed bug where consoles that failed to start could not be deleted.\n- [[#9761](https://github.com/posit-dev/positron/issues/9761)] Console: fixed issue causing code from scripts to be executed in a notebook console if it had the same language.\n- [[#9989](https://github.com/posit-dev/positron/issues/9989)] Console: fixed the \"play\" button behavior for split editors.\n- [[#10115](https://github.com/posit-dev/positron/issues/10115)] Assistant: fixed issue where Console Fix/Explain Actions were hidden when only logged in with Copilot.\n- [[#9700](https://github.com/posit-dev/positron/issues/9700)] Assistant: remove \"Next Edit Suggestions\" from being displayed in chat status.\n- [[#10332](https://github.com/posit-dev/positron/issues/10332)] Assistant: disable completions for custom providers.\n- [[#9770](https://github.com/posit-dev/positron/issues/9770), [#10719](https://github.com/posit-dev/positron/issues/10719)] Assistant: fixed Copilot tools included in chat requests not using a Copilot model and filtering the tools from the \"Configure Tools\" quick pick.\n- [[#10763](https://github.com/posit-dev/positron/issues/10763)] Assistant: fixed stale Assistant model listing when Bedrock is the only registered provider.\n- [[#10823](https://github.com/posit-dev/positron/issues/10823)] Assistant: fixed API key error when signing in to Anthropic.\n- [[#10737](https://github.com/posit-dev/positron/issues/10737)] Assistant: now show all GitHub Copilot models.\n- [[#9883](https://github.com/posit-dev/positron/issues/9883)] Assistant: enabled \"Apply in Editor\" only when using Copilot to avoid poor results from other model providers.\n- [[#10545](https://github.com/posit-dev/positron/issues/10545), [#7393](https://github.com/posit-dev/positron/issues/7393)] Python: The LSP extensions pyrefly and basedpyright can now be activated without popup errors.\n- [[#10423](https://github.com/posit-dev/positron/issues/10423)] Python: now stop the Python Environments Extension from being installed because it conflicts with internal features. You may want to uninstall this extension if it's installed already.\n- [[#9655](https://github.com/posit-dev/positron/issues/9655)] Python: silenced non-actionable syntax warnings in Python 3.14 coming from `ipykernel`.\n- [[#966](https://github.com/posit-dev/ark/issues/966)] R: fixed a bug in the R backend that caused visible errors when the `R_PROFILE` or `R_PROFILE_USER` environment variables were set to paths that don't exist.\n- [[#2951](https://github.com/posit-dev/positron/issues/2951)] Setting the activity bar position to bottom or top no longer causes duplicate tab names in the secondary side bar.\n- [[#9516](https://github.com/posit-dev/positron/issues/9516)] Added \"(preview)\" to Connections tables that are truncated to 1,000 rows.\n\n#### Dependencies\n\n- Updated `code-oss` upstream to v1.106.0.\n- Updated `vscode-python` upstream to v2025.18.0.\n\n\n## Older releases\n\nOlder releases [are available on GitHub](https://github.com/posit-dev/positron/releases), and you can also find the [release notes for previous versions](release-notes.qmd#older-releases).", + "markdown": "---\ntitle: \"Download Positron\"\ndescription: \"Download Positron for Windows, macOS, or Linux. Free data science IDE supporting Python and R with automatic updates included.\"\nformat:\n html:\n include-in-header:\n - '_download.html'\n\n---\n\n## Positron on desktop\n\nFind out what you need to know before you [install](install.qmd) Positron, then download the desktop installer for your platform.\n\n::: callout-important\n## Accept license agreement\n\nPlease review [Positron's license agreement](licensing.qmd) and [privacy policy](https://posit.co/about/privacy-policy/). Your acceptance of this license agreement and privacy policy is required as a condition to proceeding with your download or use of the software.\n\n
\n \n \n
\n:::\n\n\n\n::: {.cell .plain id='download-table'}\n::: {.cell-output-display}\n`````{=html}\n\n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n
Platform Download Size SHA-256
Windows 10, 11 x64 (system level install) Positron-2025.12.1-4-Setup-x64.exe 340M 24977b5
Windows 10, 11 x64 (user level install) Positron-2025.12.1-4-UserSetup-x64.exe 340M 9d4eee6
MacOS 11.0+ (universal) Positron-2025.12.1-4-universal.dmg 917M f53d1a7
MacOS 11.0+ (arm64/Apple Silicon) Positron-2025.12.1-4-arm64.dmg 634M 422c197
MacOS 11.0+ (x64/Intel) Positron-2025.12.1-4-x64.dmg 632M 906f545
Debian-based Linux x64 (Ubuntu 20+) Positron-2025.12.1-4-x64.deb 341M 32eac7f
Debian-based Linux arm64 (Ubuntu 20+) Positron-2025.12.1-4-arm64.deb 328M 747d5b5
Red Hat-based Linux x64 (RHEL9) Positron-2025.12.1-4-x64.rpm 386M 5e45f87
Red Hat-based Linux arm64 (RHEL9) Positron-2025.12.1-4-arm64.rpm 372M dfd1a63
\n\n`````\n:::\n:::\n\n
\n\nOnce you install Positron, it will [automatically check for updates moving forward](updating.qmd).\n\n## Positron Pro on Posit Workbench\n\n[Posit Workbench](https://posit.co/products/enterprise/workbench/) 2025.09.0 and later includes support for Positron Pro. To configure and use Positron Pro on Posit Workbench, please see the [Posit Workbench Administration Guide](https://docs.posit.co/ide/server-pro/positron_sessions/) and the [Positron Pro user guide](https://docs.posit.co/ide/server-pro/user/positron/getting-started/).\n\n## Release notes\n\nThe current release of Positron is {{< env RELEASE_VERSION >}}.\n\n### Patch notes\n\nThe 2025.12.1 patch release addresses [this issue](https://github.com/posit-dev/positron/issues/10904), deduplicating Python completions and fixing some situations where Python hover popups and function signature help popups wouldn't appear.\n\n### Release highlights\n\n#### Try our new Python language server options 🐍\n\nOur new release provides both a better default experience for editing Python code, as well as more flexibility for folks who want more control. We changed our Python language server approach so you can install your own extension of choice to provide syntax highlighting and other language server features; we've tested out basedpyright, ty, Pyrefly, and ZubanLS and expect all to work in Positron now. One of our goals is to provide a great \"batteries included\" experience for all users (including those who aren't sure which to choose) so, starting with this release, we now bundle the [Pyrefly](https://open-vsx.org/extension/meta/pyrefly) extension.\n\nWe no longer bundle the Pyright extension because its functionality overlaps with Pyrefly. If you do not want to use Pyrefly, disable that extension. You also will want to uninstall the Python Environments extension if you have it, because its features do not work in Positron.\n\n[Let us know](https://github.com/posit-dev/positron/discussions) how it goes with our new Python language server support!\n\n#### Positron Assistant 🤖\n\nThis release brings several improvements to make Assistant more reliable and easier to troubleshoot. Two new commands help you manage your Assistant configuration:\n\n- _Positron Assistant: Reset State_ lets you start totally fresh when needed.\n- _Positron Assistant: Collect Diagnostics_ generates a diagnostics report to help identify issues. \n \nWe have also improved token efficiency across many tools and introduced preview support for Snowflake Cortex as a language model provider.\n\n#### Run your code with new keyboard shortcuts 💥\n\nThe most upvoted feature in this month's release is a new set of keyboard shortcuts for running code from your document beginning to the current line Ctrl/Cmd+Alt+Home and from the current line to your document end Ctrl/Cmd+Alt+End. If you opt in the RStudio Keymap, these are available as Ctrl/Cmd+Alt+B and Ctrl/Cmd+Alt+E.\n\n
\n\n### Changelog\n\n#### New features\n\n- [[#10104](https://github.com/posit-dev/positron/issues/10104), [#10243](https://github.com/posit-dev/positron/issues/10243), [#10241](https://github.com/posit-dev/positron/issues/10241)] Added new Catalog Explorer support for Snowflake data catalogs. This feature is in preview and can be enabled by opting in to the new [`catalogExplorer.enable`](positron://settings/catalogExplorer.enable) setting.\n- [[#10430](https://github.com/posit-dev/positron/issues/10430)] Added Connections Pane support for Python Databricks SQL Connector.\n- [[#10431](https://github.com/posit-dev/positron/issues/10431)] Added Connections Pane support for Python Google BigQuery.\n- [[#10348](https://github.com/posit-dev/positron/issues/10348), [#10236](https://github.com/posit-dev/positron/issues/10236)] Assistant: improved token efficiency of project tools.\n- [[#10346](https://github.com/posit-dev/positron/issues/10346)] Assistant: added command _Positron Assistant: Reset State_ to reset Assistant state.\n- [[#10344](https://github.com/posit-dev/positron/issues/10344)] Assistant: added command _Positron Assistant: Collect Diagnostics_ to generate a diagnostics report.\n- [[#10179](https://github.com/posit-dev/positron/issues/10179)] Assistant: on Posit Workbench, AWS Bedrock is automatically enabled within Assistant when Managed Credentials are available.\n- [[#9652](https://github.com/posit-dev/positron/issues/9652)] Assistant: the AWS Bedrock provider now gracefully handles credential expiration, and automatically refreshes them with the `aws` CLI tool.\n- [[#9971](https://github.com/posit-dev/positron/issues/9971)] Assistant: added initial support for user-defined model listing.\n- [[#8613](https://github.com/posit-dev/positron/issues/8613)] Assistant: added preview support for Snowflake Cortex language model provider with OAuth managed credentials integration.\n- [[#8334](https://github.com/posit-dev/positron/issues/8334)] Added a new layout preset for an Assistant-centric workflow (in addition to the existing stacked, side-by-side, and notebook layout presets).\n- [[#3731](https://github.com/posit-dev/positron/issues/3731), [#10304](https://github.com/posit-dev/positron/issues/10304)] Python: we now bundle the Pyrefly extension, which gives a much richer Python editing experience, including better syntax highlighting.\n- [[#2318](https://github.com/posit-dev/positron/issues/2318)] R: now apply syntax highlighting to roxygen `@examplesIf` sections.\n- [[#10325](https://github.com/posit-dev/positron/issues/10325)] R: added shim for `rstudioapi::readRStudioPreference()`.\n- [[#7430](https://github.com/posit-dev/positron/issues/7430)] R: allow extensions to contribute F1 \"show help topic\" entries.\n- [[#10645](https://github.com/posit-dev/positron/issues/10645)] R: the syntax highlighting for `T` and `F` now treats them as regular variables (since they are not reserved words or constants in R).\n- [[#8559](https://github.com/posit-dev/positron/issues/8559)] R: Cmd/Ctrl+Enter within roxygen2 `@examples` and `@examplesIf` tags now executes entire R expressions rather than executing one line at a time.\n- [[#4395](https://github.com/posit-dev/positron/issues/4395)] Added new keyboard shortcuts to run code from the document beginning to the current line Ctrl/Cmd+Alt+Home and from the current line to the document end Ctrl/Cmd+Alt+End. If you opt in the RStudio Keymap, these are available as Ctrl/Cmd+Alt+B and Ctrl/Cmd+Alt+E.\n- [[#6479](https://github.com/posit-dev/positron/issues/6479)] Added a new [`workbench.topActionBar.visible`](positron://settings/workbench.topActionBar.visible) setting to control whether the Positron top bar is visible.\n- [[#7054](https://github.com/posit-dev/positron/issues/7054)] Added new command _Plots: Open Plots Gallery in New Window_ to open the whole Plots pane UI in an auxiliary window. You can also pop out the new standalone window from the plots action bar.\n- [[#10329](https://github.com/posit-dev/positron/issues/10329)] Added new setting [`plots.historyPolicy`](positron://settings/plots.historyPolicy) to control when the plot history filmstrip is visible.\n- [[#7747](https://github.com/posit-dev/positron/issues/7747)] Added new button to interrupt a running app (such as Streamlit or FastAPI) from the Viewer pane.\n- [[#10580](https://github.com/posit-dev/positron/issues/10580)] Added new command `positron.executeCodeInConsole` for extensions to execute code for a given language, URI, and position (such as for the Quarto visual editor).\n\n\n#### Bug fixes\n\n- [[#4604](https://github.com/posit-dev/positron/issues/4604)] Console: fixed interrupt of Python console on Windows.\n- [[#10382](https://github.com/posit-dev/positron/issues/10382)] Console: fixed rendering of Python data frames in the console.\n- [[#8303](https://github.com/posit-dev/positron/issues/8303)] Console: fixed bug where consoles that failed to start could not be deleted.\n- [[#9761](https://github.com/posit-dev/positron/issues/9761)] Console: fixed issue causing code from scripts to be executed in a notebook console if it had the same language.\n- [[#9989](https://github.com/posit-dev/positron/issues/9989)] Console: fixed the \"play\" button behavior for split editors.\n- [[#10115](https://github.com/posit-dev/positron/issues/10115)] Assistant: fixed issue where Console Fix/Explain Actions were hidden when only logged in with Copilot.\n- [[#9700](https://github.com/posit-dev/positron/issues/9700)] Assistant: remove \"Next Edit Suggestions\" from being displayed in chat status.\n- [[#10332](https://github.com/posit-dev/positron/issues/10332)] Assistant: disable completions for custom providers.\n- [[#9770](https://github.com/posit-dev/positron/issues/9770), [#10719](https://github.com/posit-dev/positron/issues/10719)] Assistant: fixed Copilot tools included in chat requests not using a Copilot model and filtering the tools from the \"Configure Tools\" quick pick.\n- [[#10763](https://github.com/posit-dev/positron/issues/10763)] Assistant: fixed stale Assistant model listing when Bedrock is the only registered provider.\n- [[#10823](https://github.com/posit-dev/positron/issues/10823)] Assistant: fixed API key error when signing in to Anthropic.\n- [[#10737](https://github.com/posit-dev/positron/issues/10737)] Assistant: now show all GitHub Copilot models.\n- [[#9883](https://github.com/posit-dev/positron/issues/9883)] Assistant: enabled \"Apply in Editor\" only when using Copilot to avoid poor results from other model providers.\n- [[#10545](https://github.com/posit-dev/positron/issues/10545), [#7393](https://github.com/posit-dev/positron/issues/7393)] Python: The LSP extensions pyrefly and basedpyright can now be activated without popup errors.\n- [[#10423](https://github.com/posit-dev/positron/issues/10423)] Python: now stop the Python Environments Extension from being installed because it conflicts with internal features. You may want to uninstall this extension if it's installed already.\n- [[#9655](https://github.com/posit-dev/positron/issues/9655)] Python: silenced non-actionable syntax warnings in Python 3.14 coming from `ipykernel`.\n- [[#966](https://github.com/posit-dev/ark/issues/966)] R: fixed a bug in the R backend that caused visible errors when the `R_PROFILE` or `R_PROFILE_USER` environment variables were set to paths that don't exist.\n- [[#2951](https://github.com/posit-dev/positron/issues/2951)] Setting the activity bar position to bottom or top no longer causes duplicate tab names in the secondary side bar.\n- [[#9516](https://github.com/posit-dev/positron/issues/9516)] Added \"(preview)\" to Connections tables that are truncated to 1,000 rows.\n\n#### Dependencies\n\n- Updated `code-oss` upstream to v1.106.0.\n- Updated `vscode-python` upstream to v2025.18.0.\n\n\n## Older releases\n\nOlder releases [are available on GitHub](https://github.com/posit-dev/positron/releases), and you can also find the [release notes for previous versions](release-notes.qmd#older-releases).", "supporting": [], "filters": [ "rmarkdown/pagebreak.lua" diff --git a/_freeze/install/execute-results/html.json b/_freeze/install/execute-results/html.json index bbf7637f..132dcfe0 100644 --- a/_freeze/install/execute-results/html.json +++ b/_freeze/install/execute-results/html.json @@ -1,8 +1,8 @@ { - "hash": "28f78563ba45adbab1f59f80422bf2f9", + "hash": "d31d35efc0941f0284c59dc9de62fb69", "result": { "engine": "knitr", - "markdown": "---\ntitle: \"Install Positron\"\nformat:\n html:\n include-in-header:\n - '_download.html'\naliases:\n - start.html\n---\n\nPositron is a modern, extensible IDE for data science built on [Code OSS](https://github.com/microsoft/vscode). Before you install Positron, please review the prerequisites below to ensure your system is ready.\n\n## Prerequisites\n::: {.panel-tabset}\n\n### Windows\n\nIf you're using Windows, make sure you have the [latest Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-microsoft-visual-c-redistributable-version) installed.\n\n### Python setup\nPositron works with [actively supported versions](https://devguide.python.org/versions/#versions) of Python, from 3.9 to 3.13.\n\nWe recommend [uv](https://docs.astral.sh/uv/guides/install-python/), or [pyenv](https://github.com/pyenv/pyenv) and [pyenv for Windows](https://github.com/pyenv-win/pyenv-win), for managing Python versions.\n\nPositron requires the [IPython kernel](https://pypi.org/project/ipykernel/) (version 6.19.1 or higher) to communicate with Python. By default, the IPython kernel is bundled with Positron for the CPython implementation (the standard Python implementation) and added to the [Python search path](https://docs.python.org/3/library/sys_path_init.html).\n\nIf you prefer finer control over your Python environment, set the [`python.useBundledIpykernel`](positron://settings/python.useBundledIpykernel) setting to false and install the IPython kernel manually\n\n::: callout-note\nIf you're using an implementation other than CPython, you'll need to install the IPython kernel manually.\n:::\n\n### R setup\n\nIf you plan to use R with Positron, ensure you have R 4.2 or higher installed. To install R, follow the instructions for your operating system at .\n\nAlternatively, if you'd like to have multiple R installations, [rig](https://github.com/r-lib/rig) is a great tool to manage this which works well with Positron.\n\nIf you're an R package developer, you will also want to make sure that you have the current versions of certain R packages, all of which had recent updates to make them work more smoothly in Positron. Run one of the code snippets below to ensure that you are up-to-date:\n\n``` r\n# if you're a pak person (we are!)\npak::pak(c(\"usethis\", \"cli\", \"crayon\", \"rlang\", \"roxygen2\", \"pkgload\"))\n\n# or using base R\ninstall.packages(c(\"usethis\", \"cli\", \"crayon\", \"rlang\", \"roxygen2\", \"pkgload\"))\n```\n\n::: callout-note\nIf you're a Windows user, note that Positron doesn't currently bundle [Rtools](https://cran.r-project.org/bin/windows/Rtools/). If you need Rtools for your package development or other work, you can either use the official guidance from CRAN on installing Rtools and putting it on the PATH, or alternatively, use [rig](https://github.com/r-lib/rig) to install and set up Rtools:\n\n```bash\nrig system rtools add\n```\n:::\n\n:::\n\n## Install Positron\n\nDownload the installer for your operating system from the button below and follow the standard installation process for your platform. You only need to install Positron once, as it [automatically updates](updating.qmd) to the latest version after installation.\n\n:::{.callout-important #privacy-policy}\n## Accept license agreement\n\nPlease review [Positron's license agreement](licensing.qmd) and [privacy policy](https://posit.co/about/privacy-policy/). Your acceptance of this license agreement and privacy policy is required as a condition to proceeding with your download or use of the software.\n\n\n:::\n\n\n\n::: {.cell}\n\n:::\n\n\n[Download Positron ](#){.btn .btn-primary .disabled #download-btn data-version=\"2025\\.12\\.1\\-4\"}\n\n[All Downloads](download.qmd){#all-downloads}\n", + "markdown": "---\ntitle: \"Install Positron\"\ndescription: \"Get started with Positron right away. Install the free data science IDE for Python and R, with prerequisites and setup instructions for all platforms.\"\nformat:\n html:\n include-in-header:\n - '_download.html'\naliases:\n - start.html\n---\n\nPositron is a modern, extensible IDE for data science built on [Code OSS](https://github.com/microsoft/vscode). Before you install Positron, please review the prerequisites below to ensure your system is ready.\n\n## Prerequisites\n::: {.panel-tabset}\n\n### Windows\n\nIf you're using Windows, make sure you have the [latest Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-microsoft-visual-c-redistributable-version) installed.\n\n### Python setup\nPositron works with [actively supported versions](https://devguide.python.org/versions/#versions) of Python, from 3.9 to 3.13.\n\nWe recommend [uv](https://docs.astral.sh/uv/guides/install-python/), or [pyenv](https://github.com/pyenv/pyenv) and [pyenv for Windows](https://github.com/pyenv-win/pyenv-win), for managing Python versions.\n\nPositron requires the [IPython kernel](https://pypi.org/project/ipykernel/) (version 6.19.1 or higher) to communicate with Python. By default, the IPython kernel is bundled with Positron for the CPython implementation (the standard Python implementation) and added to the [Python search path](https://docs.python.org/3/library/sys_path_init.html).\n\nIf you prefer finer control over your Python environment, set the [`python.useBundledIpykernel`](positron://settings/python.useBundledIpykernel) setting to false and install the IPython kernel manually\n\n::: callout-note\nIf you're using an implementation other than CPython, you'll need to install the IPython kernel manually.\n:::\n\n### R setup\n\nIf you plan to use R with Positron, ensure you have R 4.2 or higher installed. To install R, follow the instructions for your operating system at .\n\nAlternatively, if you'd like to have multiple R installations, [rig](https://github.com/r-lib/rig) is a great tool to manage this which works well with Positron.\n\nIf you're an R package developer, you will also want to make sure that you have the current versions of certain R packages, all of which had recent updates to make them work more smoothly in Positron. Run one of the code snippets below to ensure that you are up-to-date:\n\n``` r\n# if you're a pak person (we are!)\npak::pak(c(\"usethis\", \"cli\", \"crayon\", \"rlang\", \"roxygen2\", \"pkgload\"))\n\n# or using base R\ninstall.packages(c(\"usethis\", \"cli\", \"crayon\", \"rlang\", \"roxygen2\", \"pkgload\"))\n```\n\n::: callout-note\nIf you're a Windows user, note that Positron doesn't currently bundle [Rtools](https://cran.r-project.org/bin/windows/Rtools/). If you need Rtools for your package development or other work, you can either use the official guidance from CRAN on installing Rtools and putting it on the PATH, or alternatively, use [rig](https://github.com/r-lib/rig) to install and set up Rtools:\n\n```bash\nrig system rtools add\n```\n:::\n\n:::\n\n## Install Positron\n\nDownload the installer for your operating system from the button below and follow the standard installation process for your platform. You only need to install Positron once, as it [automatically updates](updating.qmd) to the latest version after installation.\n\n:::{.callout-important #privacy-policy}\n## Accept license agreement\n\nPlease review [Positron's license agreement](licensing.qmd) and [privacy policy](https://posit.co/about/privacy-policy/). Your acceptance of this license agreement and privacy policy is required as a condition to proceeding with your download or use of the software.\n\n\n:::\n\n\n\n::: {.cell}\n\n:::\n\n\n[Download Positron ](#){.btn .btn-primary .disabled #download-btn data-version=\"2025\\.12\\.1\\-4\"}\n\n[All Downloads](download.qmd){#all-downloads}\n", "supporting": [], "filters": [ "rmarkdown/pagebreak.lua" diff --git a/_freeze/release-notes/execute-results/html.json b/_freeze/release-notes/execute-results/html.json index 78c1a0e2..800b0cde 100644 --- a/_freeze/release-notes/execute-results/html.json +++ b/_freeze/release-notes/execute-results/html.json @@ -1,8 +1,8 @@ { - "hash": "c1564a5f9b519278f80dbbdd791ce0ea", + "hash": "4619fba27639d3b08002d88f3fb9798f", "result": { "engine": "knitr", - "markdown": "---\ntitle: \"Release Notes\"\nlisting:\n type: table\n sort: \"title desc\"\n fields: [\"title\", \"subtitle\"]\n field-display-names:\n title: \"Release\"\n subtitle: \"Link\"\n contents:\n - \"release-notes/release-2025-*.qmd\"\n---\n\n\n::: {.cell}\n\n:::\n\n\n## Latest release\n\nThe current release of Positron is {{< env RELEASE_VERSION >}}.\n\n### Patch notes\n\nThe 2025.12.1 patch release addresses [this issue](https://github.com/posit-dev/positron/issues/10904), deduplicating Python completions and fixing some situations where Python hover popups and function signature help popups wouldn't appear.\n\n### Release highlights\n\n#### Try our new Python language server options 🐍\n\nOur new release provides both a better default experience for editing Python code, as well as more flexibility for folks who want more control. We changed our Python language server approach so you can install your own extension of choice to provide syntax highlighting and other language server features; we've tested out basedpyright, ty, Pyrefly, and ZubanLS and expect all to work in Positron now. One of our goals is to provide a great \"batteries included\" experience for all users (including those who aren't sure which to choose) so, starting with this release, we now bundle the [Pyrefly](https://open-vsx.org/extension/meta/pyrefly) extension.\n\nWe no longer bundle the Pyright extension because its functionality overlaps with Pyrefly. If you do not want to use Pyrefly, disable that extension. You also will want to uninstall the Python Environments extension if you have it, because its features do not work in Positron.\n\n[Let us know](https://github.com/posit-dev/positron/discussions) how it goes with our new Python language server support!\n\n#### Positron Assistant 🤖\n\nThis release brings several improvements to make Assistant more reliable and easier to troubleshoot. Two new commands help you manage your Assistant configuration:\n\n- _Positron Assistant: Reset State_ lets you start totally fresh when needed.\n- _Positron Assistant: Collect Diagnostics_ generates a diagnostics report to help identify issues. \n \nWe have also improved token efficiency across many tools and introduced preview support for Snowflake Cortex as a language model provider.\n\n#### Run your code with new keyboard shortcuts 💥\n\nThe most upvoted feature in this month's release is a new set of keyboard shortcuts for running code from your document beginning to the current line Ctrl/Cmd+Alt+Home and from the current line to your document end Ctrl/Cmd+Alt+End. If you opt in the RStudio Keymap, these are available as Ctrl/Cmd+Alt+B and Ctrl/Cmd+Alt+E.\n\n
\n\n### Changelog\n\n#### New features\n\n- [[#10104](https://github.com/posit-dev/positron/issues/10104), [#10243](https://github.com/posit-dev/positron/issues/10243), [#10241](https://github.com/posit-dev/positron/issues/10241)] Added new Catalog Explorer support for Snowflake data catalogs. This feature is in preview and can be enabled by opting in to the new [`catalogExplorer.enable`](positron://settings/catalogExplorer.enable) setting.\n- [[#10430](https://github.com/posit-dev/positron/issues/10430)] Added Connections Pane support for Python Databricks SQL Connector.\n- [[#10431](https://github.com/posit-dev/positron/issues/10431)] Added Connections Pane support for Python Google BigQuery.\n- [[#10348](https://github.com/posit-dev/positron/issues/10348), [#10236](https://github.com/posit-dev/positron/issues/10236)] Assistant: improved token efficiency of project tools.\n- [[#10346](https://github.com/posit-dev/positron/issues/10346)] Assistant: added command _Positron Assistant: Reset State_ to reset Assistant state.\n- [[#10344](https://github.com/posit-dev/positron/issues/10344)] Assistant: added command _Positron Assistant: Collect Diagnostics_ to generate a diagnostics report.\n- [[#10179](https://github.com/posit-dev/positron/issues/10179)] Assistant: on Posit Workbench, AWS Bedrock is automatically enabled within Assistant when Managed Credentials are available.\n- [[#9652](https://github.com/posit-dev/positron/issues/9652)] Assistant: the AWS Bedrock provider now gracefully handles credential expiration, and automatically refreshes them with the `aws` CLI tool.\n- [[#9971](https://github.com/posit-dev/positron/issues/9971)] Assistant: added initial support for user-defined model listing.\n- [[#8613](https://github.com/posit-dev/positron/issues/8613)] Assistant: added preview support for Snowflake Cortex language model provider with OAuth managed credentials integration.\n- [[#8334](https://github.com/posit-dev/positron/issues/8334)] Added a new layout preset for an Assistant-centric workflow (in addition to the existing stacked, side-by-side, and notebook layout presets).\n- [[#3731](https://github.com/posit-dev/positron/issues/3731), [#10304](https://github.com/posit-dev/positron/issues/10304)] Python: we now bundle the Pyrefly extension, which gives a much richer Python editing experience, including better syntax highlighting.\n- [[#2318](https://github.com/posit-dev/positron/issues/2318)] R: now apply syntax highlighting to roxygen `@examplesIf` sections.\n- [[#10325](https://github.com/posit-dev/positron/issues/10325)] R: added shim for `rstudioapi::readRStudioPreference()`.\n- [[#7430](https://github.com/posit-dev/positron/issues/7430)] R: allow extensions to contribute F1 \"show help topic\" entries.\n- [[#10645](https://github.com/posit-dev/positron/issues/10645)] R: the syntax highlighting for `T` and `F` now treats them as regular variables (since they are not reserved words or constants in R).\n- [[#8559](https://github.com/posit-dev/positron/issues/8559)] R: Cmd/Ctrl+Enter within roxygen2 `@examples` and `@examplesIf` tags now executes entire R expressions rather than executing one line at a time.\n- [[#4395](https://github.com/posit-dev/positron/issues/4395)] Added new keyboard shortcuts to run code from the document beginning to the current line Ctrl/Cmd+Alt+Home and from the current line to the document end Ctrl/Cmd+Alt+End. If you opt in the RStudio Keymap, these are available as Ctrl/Cmd+Alt+B and Ctrl/Cmd+Alt+E.\n- [[#6479](https://github.com/posit-dev/positron/issues/6479)] Added a new [`workbench.topActionBar.visible`](positron://settings/workbench.topActionBar.visible) setting to control whether the Positron top bar is visible.\n- [[#7054](https://github.com/posit-dev/positron/issues/7054)] Added new command _Plots: Open Plots Gallery in New Window_ to open the whole Plots pane UI in an auxiliary window. You can also pop out the new standalone window from the plots action bar.\n- [[#10329](https://github.com/posit-dev/positron/issues/10329)] Added new setting [`plots.historyPolicy`](positron://settings/plots.historyPolicy) to control when the plot history filmstrip is visible.\n- [[#7747](https://github.com/posit-dev/positron/issues/7747)] Added new button to interrupt a running app (such as Streamlit or FastAPI) from the Viewer pane.\n- [[#10580](https://github.com/posit-dev/positron/issues/10580)] Added new command `positron.executeCodeInConsole` for extensions to execute code for a given language, URI, and position (such as for the Quarto visual editor).\n\n\n#### Bug fixes\n\n- [[#4604](https://github.com/posit-dev/positron/issues/4604)] Console: fixed interrupt of Python console on Windows.\n- [[#10382](https://github.com/posit-dev/positron/issues/10382)] Console: fixed rendering of Python data frames in the console.\n- [[#8303](https://github.com/posit-dev/positron/issues/8303)] Console: fixed bug where consoles that failed to start could not be deleted.\n- [[#9761](https://github.com/posit-dev/positron/issues/9761)] Console: fixed issue causing code from scripts to be executed in a notebook console if it had the same language.\n- [[#9989](https://github.com/posit-dev/positron/issues/9989)] Console: fixed the \"play\" button behavior for split editors.\n- [[#10115](https://github.com/posit-dev/positron/issues/10115)] Assistant: fixed issue where Console Fix/Explain Actions were hidden when only logged in with Copilot.\n- [[#9700](https://github.com/posit-dev/positron/issues/9700)] Assistant: remove \"Next Edit Suggestions\" from being displayed in chat status.\n- [[#10332](https://github.com/posit-dev/positron/issues/10332)] Assistant: disable completions for custom providers.\n- [[#9770](https://github.com/posit-dev/positron/issues/9770), [#10719](https://github.com/posit-dev/positron/issues/10719)] Assistant: fixed Copilot tools included in chat requests not using a Copilot model and filtering the tools from the \"Configure Tools\" quick pick.\n- [[#10763](https://github.com/posit-dev/positron/issues/10763)] Assistant: fixed stale Assistant model listing when Bedrock is the only registered provider.\n- [[#10823](https://github.com/posit-dev/positron/issues/10823)] Assistant: fixed API key error when signing in to Anthropic.\n- [[#10737](https://github.com/posit-dev/positron/issues/10737)] Assistant: now show all GitHub Copilot models.\n- [[#9883](https://github.com/posit-dev/positron/issues/9883)] Assistant: enabled \"Apply in Editor\" only when using Copilot to avoid poor results from other model providers.\n- [[#10545](https://github.com/posit-dev/positron/issues/10545), [#7393](https://github.com/posit-dev/positron/issues/7393)] Python: The LSP extensions pyrefly and basedpyright can now be activated without popup errors.\n- [[#10423](https://github.com/posit-dev/positron/issues/10423)] Python: now stop the Python Environments Extension from being installed because it conflicts with internal features. You may want to uninstall this extension if it's installed already.\n- [[#9655](https://github.com/posit-dev/positron/issues/9655)] Python: silenced non-actionable syntax warnings in Python 3.14 coming from `ipykernel`.\n- [[#966](https://github.com/posit-dev/ark/issues/966)] R: fixed a bug in the R backend that caused visible errors when the `R_PROFILE` or `R_PROFILE_USER` environment variables were set to paths that don't exist.\n- [[#2951](https://github.com/posit-dev/positron/issues/2951)] Setting the activity bar position to bottom or top no longer causes duplicate tab names in the secondary side bar.\n- [[#9516](https://github.com/posit-dev/positron/issues/9516)] Added \"(preview)\" to Connections tables that are truncated to 1,000 rows.\n\n#### Dependencies\n\n- Updated `code-oss` upstream to v1.106.0.\n- Updated `vscode-python` upstream to v2025.18.0.\n\n\n## Older releases\n", + "markdown": "---\ntitle: \"Release Notes\"\ndescription: \"View release notes for all Positron versions. Track new features, bug fixes, and improvements across monthly releases.\"\nlisting:\n type: table\n sort: \"title desc\"\n fields: [\"title\", \"subtitle\"]\n field-display-names:\n title: \"Release\"\n subtitle: \"Link\"\n contents:\n - \"release-notes/release-2025-*.qmd\"\n---\n\n\n::: {.cell}\n\n:::\n\n\n## Latest release\n\nThe current release of Positron is {{< env RELEASE_VERSION >}}.\n\n### Patch notes\n\nThe 2025.12.1 patch release addresses [this issue](https://github.com/posit-dev/positron/issues/10904), deduplicating Python completions and fixing some situations where Python hover popups and function signature help popups wouldn't appear.\n\n### Release highlights\n\n#### Try our new Python language server options 🐍\n\nOur new release provides both a better default experience for editing Python code, as well as more flexibility for folks who want more control. We changed our Python language server approach so you can install your own extension of choice to provide syntax highlighting and other language server features; we've tested out basedpyright, ty, Pyrefly, and ZubanLS and expect all to work in Positron now. One of our goals is to provide a great \"batteries included\" experience for all users (including those who aren't sure which to choose) so, starting with this release, we now bundle the [Pyrefly](https://open-vsx.org/extension/meta/pyrefly) extension.\n\nWe no longer bundle the Pyright extension because its functionality overlaps with Pyrefly. If you do not want to use Pyrefly, disable that extension. You also will want to uninstall the Python Environments extension if you have it, because its features do not work in Positron.\n\n[Let us know](https://github.com/posit-dev/positron/discussions) how it goes with our new Python language server support!\n\n#### Positron Assistant 🤖\n\nThis release brings several improvements to make Assistant more reliable and easier to troubleshoot. Two new commands help you manage your Assistant configuration:\n\n- _Positron Assistant: Reset State_ lets you start totally fresh when needed.\n- _Positron Assistant: Collect Diagnostics_ generates a diagnostics report to help identify issues. \n \nWe have also improved token efficiency across many tools and introduced preview support for Snowflake Cortex as a language model provider.\n\n#### Run your code with new keyboard shortcuts 💥\n\nThe most upvoted feature in this month's release is a new set of keyboard shortcuts for running code from your document beginning to the current line Ctrl/Cmd+Alt+Home and from the current line to your document end Ctrl/Cmd+Alt+End. If you opt in the RStudio Keymap, these are available as Ctrl/Cmd+Alt+B and Ctrl/Cmd+Alt+E.\n\n
\n\n### Changelog\n\n#### New features\n\n- [[#10104](https://github.com/posit-dev/positron/issues/10104), [#10243](https://github.com/posit-dev/positron/issues/10243), [#10241](https://github.com/posit-dev/positron/issues/10241)] Added new Catalog Explorer support for Snowflake data catalogs. This feature is in preview and can be enabled by opting in to the new [`catalogExplorer.enable`](positron://settings/catalogExplorer.enable) setting.\n- [[#10430](https://github.com/posit-dev/positron/issues/10430)] Added Connections Pane support for Python Databricks SQL Connector.\n- [[#10431](https://github.com/posit-dev/positron/issues/10431)] Added Connections Pane support for Python Google BigQuery.\n- [[#10348](https://github.com/posit-dev/positron/issues/10348), [#10236](https://github.com/posit-dev/positron/issues/10236)] Assistant: improved token efficiency of project tools.\n- [[#10346](https://github.com/posit-dev/positron/issues/10346)] Assistant: added command _Positron Assistant: Reset State_ to reset Assistant state.\n- [[#10344](https://github.com/posit-dev/positron/issues/10344)] Assistant: added command _Positron Assistant: Collect Diagnostics_ to generate a diagnostics report.\n- [[#10179](https://github.com/posit-dev/positron/issues/10179)] Assistant: on Posit Workbench, AWS Bedrock is automatically enabled within Assistant when Managed Credentials are available.\n- [[#9652](https://github.com/posit-dev/positron/issues/9652)] Assistant: the AWS Bedrock provider now gracefully handles credential expiration, and automatically refreshes them with the `aws` CLI tool.\n- [[#9971](https://github.com/posit-dev/positron/issues/9971)] Assistant: added initial support for user-defined model listing.\n- [[#8613](https://github.com/posit-dev/positron/issues/8613)] Assistant: added preview support for Snowflake Cortex language model provider with OAuth managed credentials integration.\n- [[#8334](https://github.com/posit-dev/positron/issues/8334)] Added a new layout preset for an Assistant-centric workflow (in addition to the existing stacked, side-by-side, and notebook layout presets).\n- [[#3731](https://github.com/posit-dev/positron/issues/3731), [#10304](https://github.com/posit-dev/positron/issues/10304)] Python: we now bundle the Pyrefly extension, which gives a much richer Python editing experience, including better syntax highlighting.\n- [[#2318](https://github.com/posit-dev/positron/issues/2318)] R: now apply syntax highlighting to roxygen `@examplesIf` sections.\n- [[#10325](https://github.com/posit-dev/positron/issues/10325)] R: added shim for `rstudioapi::readRStudioPreference()`.\n- [[#7430](https://github.com/posit-dev/positron/issues/7430)] R: allow extensions to contribute F1 \"show help topic\" entries.\n- [[#10645](https://github.com/posit-dev/positron/issues/10645)] R: the syntax highlighting for `T` and `F` now treats them as regular variables (since they are not reserved words or constants in R).\n- [[#8559](https://github.com/posit-dev/positron/issues/8559)] R: Cmd/Ctrl+Enter within roxygen2 `@examples` and `@examplesIf` tags now executes entire R expressions rather than executing one line at a time.\n- [[#4395](https://github.com/posit-dev/positron/issues/4395)] Added new keyboard shortcuts to run code from the document beginning to the current line Ctrl/Cmd+Alt+Home and from the current line to the document end Ctrl/Cmd+Alt+End. If you opt in the RStudio Keymap, these are available as Ctrl/Cmd+Alt+B and Ctrl/Cmd+Alt+E.\n- [[#6479](https://github.com/posit-dev/positron/issues/6479)] Added a new [`workbench.topActionBar.visible`](positron://settings/workbench.topActionBar.visible) setting to control whether the Positron top bar is visible.\n- [[#7054](https://github.com/posit-dev/positron/issues/7054)] Added new command _Plots: Open Plots Gallery in New Window_ to open the whole Plots pane UI in an auxiliary window. You can also pop out the new standalone window from the plots action bar.\n- [[#10329](https://github.com/posit-dev/positron/issues/10329)] Added new setting [`plots.historyPolicy`](positron://settings/plots.historyPolicy) to control when the plot history filmstrip is visible.\n- [[#7747](https://github.com/posit-dev/positron/issues/7747)] Added new button to interrupt a running app (such as Streamlit or FastAPI) from the Viewer pane.\n- [[#10580](https://github.com/posit-dev/positron/issues/10580)] Added new command `positron.executeCodeInConsole` for extensions to execute code for a given language, URI, and position (such as for the Quarto visual editor).\n\n\n#### Bug fixes\n\n- [[#4604](https://github.com/posit-dev/positron/issues/4604)] Console: fixed interrupt of Python console on Windows.\n- [[#10382](https://github.com/posit-dev/positron/issues/10382)] Console: fixed rendering of Python data frames in the console.\n- [[#8303](https://github.com/posit-dev/positron/issues/8303)] Console: fixed bug where consoles that failed to start could not be deleted.\n- [[#9761](https://github.com/posit-dev/positron/issues/9761)] Console: fixed issue causing code from scripts to be executed in a notebook console if it had the same language.\n- [[#9989](https://github.com/posit-dev/positron/issues/9989)] Console: fixed the \"play\" button behavior for split editors.\n- [[#10115](https://github.com/posit-dev/positron/issues/10115)] Assistant: fixed issue where Console Fix/Explain Actions were hidden when only logged in with Copilot.\n- [[#9700](https://github.com/posit-dev/positron/issues/9700)] Assistant: remove \"Next Edit Suggestions\" from being displayed in chat status.\n- [[#10332](https://github.com/posit-dev/positron/issues/10332)] Assistant: disable completions for custom providers.\n- [[#9770](https://github.com/posit-dev/positron/issues/9770), [#10719](https://github.com/posit-dev/positron/issues/10719)] Assistant: fixed Copilot tools included in chat requests not using a Copilot model and filtering the tools from the \"Configure Tools\" quick pick.\n- [[#10763](https://github.com/posit-dev/positron/issues/10763)] Assistant: fixed stale Assistant model listing when Bedrock is the only registered provider.\n- [[#10823](https://github.com/posit-dev/positron/issues/10823)] Assistant: fixed API key error when signing in to Anthropic.\n- [[#10737](https://github.com/posit-dev/positron/issues/10737)] Assistant: now show all GitHub Copilot models.\n- [[#9883](https://github.com/posit-dev/positron/issues/9883)] Assistant: enabled \"Apply in Editor\" only when using Copilot to avoid poor results from other model providers.\n- [[#10545](https://github.com/posit-dev/positron/issues/10545), [#7393](https://github.com/posit-dev/positron/issues/7393)] Python: The LSP extensions pyrefly and basedpyright can now be activated without popup errors.\n- [[#10423](https://github.com/posit-dev/positron/issues/10423)] Python: now stop the Python Environments Extension from being installed because it conflicts with internal features. You may want to uninstall this extension if it's installed already.\n- [[#9655](https://github.com/posit-dev/positron/issues/9655)] Python: silenced non-actionable syntax warnings in Python 3.14 coming from `ipykernel`.\n- [[#966](https://github.com/posit-dev/ark/issues/966)] R: fixed a bug in the R backend that caused visible errors when the `R_PROFILE` or `R_PROFILE_USER` environment variables were set to paths that don't exist.\n- [[#2951](https://github.com/posit-dev/positron/issues/2951)] Setting the activity bar position to bottom or top no longer causes duplicate tab names in the secondary side bar.\n- [[#9516](https://github.com/posit-dev/positron/issues/9516)] Added \"(preview)\" to Connections tables that are truncated to 1,000 rows.\n\n#### Dependencies\n\n- Updated `code-oss` upstream to v1.106.0.\n- Updated `vscode-python` upstream to v2025.18.0.\n\n\n## Older releases\n", "supporting": [], "filters": [ "rmarkdown/pagebreak.lua" From 03794f1e878e6a15ea0e5c2c7dee0875e186e310 Mon Sep 17 00:00:00 2001 From: Julia Silge Date: Thu, 11 Dec 2025 08:08:19 -0700 Subject: [PATCH 5/5] Feedback from @cindyytong --- assistant-completions.qmd | 2 +- assistant-getting-started.qmd | 2 +- extending-connections.qmd | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/assistant-completions.qmd b/assistant-completions.qmd index 257f4e74..c2a69aa2 100644 --- a/assistant-completions.qmd +++ b/assistant-completions.qmd @@ -1,6 +1,6 @@ --- title: "Completions" -description: "Get AI-powered code suggestions as you type with GitHub Copilot completions. Inline suggestions support faster coding in Python, R, and more." +description: "Boost your productivity with AI code suggestions via Github Copilot completions. Inline suggestions support faster coding in Python, R, and more." --- Code completions are text suggestions that appear inline as you type in an editor. These suggestions can be lines or blocks of code based on the context of what you're writing. Other names for code completions include inline suggestions, ghost text, or inline completions. diff --git a/assistant-getting-started.qmd b/assistant-getting-started.qmd index 78d56076..b07a470b 100644 --- a/assistant-getting-started.qmd +++ b/assistant-getting-started.qmd @@ -1,6 +1,6 @@ --- title: "Getting Started" -description: "Set up Positron Assistant with your model provider of choice." +description: "Configure and customize Positron Assistant by connecting it to your preferred AI model provider, such as Anthropic or GitHub Copilot. Choose the exact LLM provider that fits your workflow and security needs." listing: - id: chat-features type: custom diff --git a/extending-connections.qmd b/extending-connections.qmd index f29b2490..5a7b6c54 100644 --- a/extending-connections.qmd +++ b/extending-connections.qmd @@ -1,6 +1,6 @@ --- title: "Extending the Connections Pane" -description: "Extend Positron's Connections Pane with custom connection types. Learn to add new connection providers and integrate with the New Connections modal." +description: "Extend Positron's Connections Pane with custom database connection types. Learn to add new database connection providers and integrate with the New Connections modal." format: html ---