Skip to content

Polish RStudio migration walkthrough #8625

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 24, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion extensions/positron-r/package.nls.json
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@
"r.walkthrough.migrateFromRStudio.panesAndUI.title": "Get to know the Positron UI",
"r.walkthrough.migrateFromRStudio.panesAndUI.description": "Find your way around the panes and layout of Positron\n[Customize your layout](command:workbench.action.customizeLayout)",
"r.walkthrough.migrateFromRStudio.keybindings.title": "Keyboard shortcuts",
"r.walkthrough.migrateFromRStudio.keybindings.description": "Learn about the keyboard shortcuts available in Positron for R\n[Opt in to RStudio keybindings](command:r.walkthrough.updateRStudioKeybindings)",
"r.walkthrough.migrateFromRStudio.keybindings.description": "Learn about the keyboard shortcuts available in Positron for R\n[Enable RStudio keybindings](command:r.walkthrough.updateRStudioKeybindings)",
"r.walkthrough.migrateFromRStudio.workspaces.title": "Projects, folders, and workspaces",
"r.walkthrough.migrateFromRStudio.workspaces.description": " \n[Open an existing folder](command:workbench.action.files.openFolder)",
"r.walkthrough.migrateFromRStudio.formatting.title": "Formatting your R code",
Expand Down
4 changes: 2 additions & 2 deletions extensions/positron-r/resources/walkthroughs/panes-and-ui.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Positron has many UI elements that are similar to RStudio and will feel familiar to you:

- Run code interactively in [the Console](command:workbench.action.positronConsole.focusConsole).
- Run code interactively in the [Console](command:workbench.action.positronConsole.focusConsole).
- Use the [File Explorer](command:workbench.files.action.focusFilesExplorer) to navigate your files.
- Use the [Outline](command:outline.focus) to see the structure of your R and other files, including code cells, functions, variables, and more.
- Use the [Variables pane](command:positronVariables.focus) to interactively explore the variables you have defined in your R session.
Expand All @@ -9,6 +9,6 @@ Positron has many UI elements that are similar to RStudio and will feel familiar
- Manage database connections in the [Connections pane](command:workbench.panel.positronConnections.focus).
- Use the [Terminal](command:workbench.action.terminal.focus) to run shell commands.

Positron does tend to have fewer buttons and icons than RStudio, so you will likely find yourself using the Command Palette more often. You can open the Command Palette with <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>. Then type the name of the command you want to run, such as "Focus Console" or "New Terminal". You can also use the Command Palette to search for commands by typing a keyword, such as "format" to find formatting commands.
Positron has fewer buttons and icons than RStudio, so you will likely find yourself using the Command Palette more often. You can open the Command Palette with <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>. Then type the name of the command you want to run, such as "Focus Console" or "New Terminal". You can also use the Command Palette to search for commands by typing a keyword, such as "format" to find formatting commands.

The layout of Positron is also much more customizable than RStudio. You can drag and drop panes to rearrange them, or you can use the Command Palette to run commands like "View: Toggle Primary Side Bar Visibility" or "View: Toggle Top Bar Visibility". Positron provides several layout presets appropriate for data science; [customize your layout](command:workbench.action.customizeLayout) to try out the Stacked, Side-by-Side, and Notebook layouts.
2 changes: 1 addition & 1 deletion extensions/positron-r/resources/walkthroughs/workspaces.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
In RStudio, you organize your work using **Projects**. Positron doesn't have capital-P "projects" per se, but the concept in Positron that is most analogous to an RStudio Project is a **workspace**. You can read more in the VS Code documentation about [what exactly a workspace is](https://code.visualstudio.com/docs/editor/workspaces), but in general think of a workspace as about the same thing as a folder, which is about the same thing as an RStudio Project.
In RStudio, you organize your work using **Projects** that are identified by an `.Rproj` file. Positron doesn't have an exact equivalent to RStudio Projects, but the concept in Positron that is most analogous to an RStudio Project is a **workspace**. You can read more in the VS Code documentation about [what exactly a workspace is](https://code.visualstudio.com/docs/editor/workspaces), but in general think of a workspace as about the same thing as a folder, which is about the same thing as an RStudio Project.

- If you have an existing local folder (including an RStudio project folder) that you want to work in, you can _open_ it in Positron.
- If you have an existing GitHub repository that you want to work with, you can _create_ a new local folder using ["Workspaces: New Folder from Git..."](command:positron.workbench.action.newFolderFromGit).
Expand Down
Loading