Polishing based on seeing a full preview

Author: jennybc

migrate-rstudio-code.qmd

@@ -39,6 +39,7 @@ There are various explicit and implicit gestures to run Air over your code:
   - *Format Document*
   - *Format Cell*
   - *Air: Format Workspace Folder*
+
   These are all available in the command palette.
 
 R code receives some formatting as you type, but these rules are based on regular expressions, which fundamentally limits their capability.

migrate-rstudio-keybindings.qmd

@@ -22,7 +22,7 @@ Restart Positron after changing this setting.
 | -------- | ----------- |
 | <kbd>Ctrl</kbd>+<kbd>1</kbd>  |  Focus Source |
 | <kbd>Ctrl</kbd>+<kbd>2</kbd>  |  Focus Console |
-| <kbd>Cmd/Ctrl</kbd>+<kbd>.</kbd>  |  Go to Symbol |
+| <kbd>Cmd/Ctrl</kbd>+<kbd>.</kbd>  |  Go to Function/Symbol |
 | <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>C</kbd> |  Comment/Uncomment a line |
 | <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>N</kbd> |  Create a new R file |
 | <kbd>F2</kbd>  |  Go to definition |
@@ -34,8 +34,8 @@ Restart Positron after changing this setting.
 | <kbd>Cmd/Ctrl</kbd>+<kbd>Enter</kbd> | Run current line (Quarto) |
 | <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Enter</kbd> | Run current cell (Quarto) |
 | <kbd>Cmd/Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>M</kbd> |  Open version control pane |
-| <kbd>Cmd/Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Left</kbd> |  Go to previous tab |
-| <kbd>Cmd/Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Right</kbd> |  Go to next tab |
+| <kbd>Cmd/Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Left</kbd> |  Go to previous editor tab |
+| <kbd>Cmd/Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Right</kbd> |  Go to next editor tab |
 | <kbd>Cmd/Ctrl</kbd>+<kbd>D</kbd> |  Delete the current line |
 | <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>H</kbd> | Set working directory |
 | <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>R</kbd> |  Insert section |

migrate-rstudio-navigation.qmd

@@ -10,8 +10,8 @@ This guide helps RStudio users adapt to Positron's methods for navigating throug
 | --------------- | ------- | -------- |
 | Find in Files | <kbd>Ctrl/Cmd</kbd>+<kbd>Shift</kbd>+<kbd>F</kbd> | <kbd>Ctrl/Cmd</kbd>+<kbd>Shift</kbd>+<kbd>F</kbd> <br> [Search across files](https://code.visualstudio.com/docs/editor/codebasics#_search-across-files) |
 | Go to File | <kbd>Ctrl/Cmd</kbd>+<kbd>.</kbd> | <kbd>Ctrl/Cmd</kbd>+<kbd>P</kbd> <br> [Quick open](https://code.visualstudio.com/docs/editing/editingevolved#_quick-file-navigation)|
-| Go to Function/Symbol | <kbd>Ctrl/Cmd</kbd>+<kbd>.</kbd> | With RStudio keybindings enabled: <br> <kbd>Ctrl/Cmd</kbd>+<kbd>.</kbd><br><br>Available in all configurations: <br> <kbd>Ctrl/Cmd</kbd>+<kbd>T</kbd> <br>[Go to Symbol in Workspace](https://code.visualstudio.com/docs/editor/editingevolved#_go-to-symbol)<br><br><kbd>Ctrl/Cmd</kbd>+<kbd>Shift</kbd>+<kbd>O</kbd> (symbols in current file) |
-| Go to Function Definition | <kbd>F2</kbd> or <kbd>Ctrl/Cmd</kbd> + click | <kbd>F2</kbd> <br><br> With RStudio keybindings enabled: <br> <kbd>Ctrl/Cmd</kbd> + click |
+| Go to Function/Symbol | <kbd>Ctrl/Cmd</kbd>+<kbd>.</kbd> | With RStudio keybindings enabled: <br> <kbd>Ctrl/Cmd</kbd>+<kbd>.</kbd><br><br>In all configurations: <br> <kbd>Ctrl/Cmd</kbd>+<kbd>T</kbd> <br>[Go to Symbol in Workspace](https://code.visualstudio.com/docs/editor/editingevolved#_go-to-symbol)<br><br><kbd>Ctrl/Cmd</kbd>+<kbd>Shift</kbd>+<kbd>O</kbd> (symbols in current file) |
+| Go to Function Definition | <kbd>Ctrl/Cmd</kbd> + click or <kbd>F2</kbd> | With RStudio keybindings enabled: <br> <kbd>Ctrl/Cmd</kbd> + click <br><br> In all configurations: <br> <kbd>F2</kbd> |
 | Jump to Line | <kbd>Alt/Option</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd> | <kbd>Ctrl</kbd>+<kbd>G</kbd> |
 | Navigate Back or Forward | <kbd>Ctrl/Cmd</kbd>+<kbd>F9</kbd> <br> <kbd>Ctrl/Cmd</kbd>+<kbd>F10</kbd> | Windows/Linux: <br> <kbd>Alt</kbd>+<kbd>Left</kbd><br> <kbd>Alt</kbd>+<kbd>Right</kbd> <br><br> Mac: <br> <kbd>Ctrl</kbd>+<kbd>-</kbd> <br> <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>-</kbd> |
 | Focus Previous or Next Editor Tab | <kbd>Ctrl/Cmd</kbd>+<kbd>Alt</kbd>+<kbd>Left</kbd> <br> <kbd>Ctrl/Cmd</kbd>+<kbd>Alt</kbd>+<kbd>Right</kbd> | With RStudio keybindings enabled: <br> <kbd>Ctrl/Cmd</kbd>+<kbd>Alt</kbd>+<kbd>Left</kbd> <br> <kbd>Ctrl/Cmd</kbd>+<kbd>Alt</kbd>+<kbd>Right</kbd> |

migrate-rstudio-overview.qmd

@@ -1,5 +1,5 @@
 ---
-title: "RStudio Migration Overview"
+title: "Overview"
 ---
 
 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.
@@ -42,7 +42,7 @@ There is nothing irreversible or exclusive about interacting with the files that
 ## Command Palette
 
 One overarching difference between RStudio and Positron (and VS Code) is the importance of the **command palette**.
-While RStudio offers a command palette, it was a relatively late addition to the interface and many users never got into the habit of using it.
+While RStudio offers a command palette, it was a relatively late addition to the user experience and many users never got into the habit of using it.
 Instead RStudio users are accustomed to many specialized buttons, panes, and menus.
 
 Positron leans much more heavily on the command palette, which is inherited from VS Code.

migrate-rstudio-settings-and-extensions.qmd

@@ -12,11 +12,11 @@ So here we just focus on a few that have above-average interest for an RStudio u
 
 Positron includes hundreds of configurable settings, but these 10 are particularly helpful for RStudio users transitioning to Positron:
 
-1. **RStudio Keybindings** *recommended at the user level*
+1. **RStudio Keybindings** *recommended at the user level; [read more](migrate-rstudio-keybindings.qmd)*
    ```json
    "workbench.keybindings.rstudioKeybindings": true
    ```
-1. **Format on Save with Air** *recommended at the workspace level*
+1. **Format on Save with Air** *recommended at the workspace level; [read more](migrate-rstudio-code.qmd)*
    ```json
    "[r]": {
        "editor.formatOnSave": true
@@ -38,7 +38,7 @@ Here are two interesting ways to control or extend Positron itself:
 
 ### Partial implementation of rstudioapi
 
-*Heads up on how to write defensively, i.e. check if the method is implemented.*
+*Give advice on how to write defensively, i.e. check if the method is implemented.*
 
 ### Write an extension