SEO work

Improving filenames (patching up links and redirects) and adding description metadata.

Author: Kraig Brockschmidt

.openpublishing.redirection.json

@@ -1555,6 +1555,96 @@
             "redirect_url": "/visualstudio/python/tutorial-working-with-python-in-visual-studio-step-06-working-with-git",
             "redirect_document_id": false
         },
+        {
+            "source_path": "docs/rtvs/code-editing.md",
+            "redirect_url": "/visualstudio/rtvs/editing-r-code-in-visual-studio",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/code-intellisense.md",
+            "redirect_url": "/visualstudio/rtvs/r-intellisense",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/code-linting.md",
+            "redirect_url": "/visualstudio/rtvs/linting-r-code",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/code-snippets.md",
+            "redirect_url": "/visualstudio/rtvs/code-snippets-for-r",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/data-science-workload.md",
+            "redirect_url": "",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/debugging.md",
+            "redirect_url": "/visualstudio/rtvs/debugging-r-in-visual-studio",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/installation.md",
+            "redirect_url": "/visualstudio/rtvs/installing-r-tools-for-visual-studio",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/interactive-repl.md",
+            "redirect_url": "/visualstudio/rtvs/interactive-repl-for-r-in-visual-studio",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/options.md",
+            "redirect_url": "/visualstudio/rtvs/options-for-r-tools-in-visual-studio",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/package-manager.md",
+            "redirect_url": "/visualstudio/rtvs/r-package-manager-in-visual-studio",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/projects.md",
+            "redirect_url": "/visualstudio/rtvs/r-projects-in-visual-studio",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/rmarkdown.md",
+            "redirect_url": "/visualstudio/rtvs/rmarkdown-with-r-in-visual-studio",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/sql-server.md",
+            "redirect_url": "/visualstudio/rtvs/integrating-sql-server-with-r",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/visualizing-data.md",
+            "redirect_url": "/visualstudio/rtvs/visualizing-data-with-r-in-visual-studio",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/workspaces.md",
+            "redirect_url": "/visualstudio/rtvs/r-workspaces-in-visual-studio",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/workspaces-remote-setup.md",
+            "redirect_url": "/visualstudio/rtvs/setting-up-remote-r-workspaces",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/workspaces-remote-r-service-for-linux.md",
+            "redirect_url": "/visualstudio/rtvs/setting-up-remote-r-service-on-linux",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "docs/rtvs/workspaces-using-docker-containers.md",
+            "redirect_url": "/visualstudio/rtvs/using-docker-containers-with-r",
+            "redirect_document_id": false
+        },
         {
             "source_path": "docs/sharepoint/index.md",
             "redirect_url": "/visualstudio/sharepoint/create-sharepoint-solutions",

docs/rtvs/TOC.md

@@ -1,29 +1,29 @@
 # Overview
 ## [R Tools for Visual Studio](index.md)
-## [Data science and analytical applications workload](data-science-workload.md)
+## [Data science and analytical applications workload](data-science-and-analytical-applications-workload.md)
 # Quickstarts
-## [Installation](installation.md)
+## [Installation](installing-r-tools-for-visual-studio.md)
 ## [Getting help](getting-started-help.md)
 # Tutorials
 ## [Getting started with R](getting-started-with-r.md)
 # [Samples](getting-started-samples.md)
 # How-to guides
-## [R Pprojects](projects.md)
-### [Package Manager](package-manager.md)
-### [SQL Server integration](sql-server.md)
-## [Editing code](code-editing.md)
-### [IntelliSense](code-intellisense.md)
-### [Linting](code-linting.md)
-### [Code snippets](code-snippets.md)
-## [Workspaces (local and remote)](workspaces.md)
-### [Setting up remote workspaces](workspaces-remote-setup.md)
-### [Remote R Service for Linux](workspaces-remote-r-service-for-linux.md)
-### [Using Docker containers](workspaces-using-docker-containers.md)
-## [R Markdown](rmarkdown.md)
-## [Interactive REPL](interactive-repl.md)
-## [Visualizing data](visualizing-data.md)
+## [R projects](r-projects-in-visual-studio.md)
+### [Package manager](r-package-manager-in-visual-studio.md)
+### [SQL Server integration](integrating-sql-server-with-r.md)
+## [Editing code](editing-r-code-in-visual-studio.md)
+### [IntelliSense](r-intellisense.md)
+### [Linting](linting-r-code.md)
+### [Code snippets](code-snippets-for-r.md)
+## [Workspaces (local and remote)](r-workspaces-in-visual-studio.md)
+### [Setting up remote workspaces](setting-up-remote-r-workspaces.md)
+### [Remote R Service for Linux](setting-up-remote-r-service-on-linux.md)
+### [Using Docker containers](using-docker-containers-with-r.md)
+## [R Markdown](rmarkdown-with-r-in-visual-studio.md)
+## [Interactive REPL](interactive-repl-for-r-in-visual-studio.md)
+## [Visualizing data](visualizing-data-with-r-in-visual-studio.md)
 ## [Variable Explorer](variable-explorer.md)
-## [Debugging](debugging.md)
+## [Debugging](debugging-r-in-visual-studio.md)
 # Reference
-## [Options](options.md)
+## [Options](options-for-r-tools-in-visual-studio.md)
 ## [Frequently-asked questions](faq.md)

docs/rtvs/check-for-update.md

@@ -1,7 +1,8 @@
 ---
 title: "Current version of R Tools for Visual Studio | Microsoft Docs"
+description: How to check the version of R Tools for Visual Studio and install updates.
 ms.custom: ""
-ms.date: 12/12/2017
+ms.date: 01/24/2018
 ms.reviewer: ""
 ms.suite: ""
 ms.technology: 
@@ -29,6 +30,6 @@ To update your version of RTVS in Visual Studio 2017, go to the Visual Studio in
 
 For Visual Studio 2015, the most recent installer is available from [aka.ms/rtvs-current](https://aka.ms/rtvs-current) (direct download).
 
-See [Installation](installation.md) for Visual Studio and Windows requirements.
+See [Installation](installing-r-tools-for-visual-studio.md) for Visual Studio and Windows requirements.
 
 For updates on Microsoft R Open and Microsoft R Server, see: [Microsoft R products.](http://aka.ms/rtvs-msft-r)

docs/rtvs/code-snippets.md renamed to docs/rtvs/code-snippets-for-r.md

@@ -1,7 +1,8 @@
 ---
 title: Code snippets with R Tools for Visual Studio | Microsoft Docs
+description: Code snippets for R in Visual Studio provide shortcuts to quickly insert code blocks of arbitrary length, helping you avoid retyping similar code over and over.
 ms.custom: ""
-ms.date: 06/29/2017
+ms.date: 01/24/2018
 ms.reviewer: ""
 ms.suite: ""
 ms.technology: 

docs/rtvs/data-science-workload.md renamed to docs/rtvs/data-science-and-analytical-applications-workload.md

@@ -1,7 +1,8 @@
 ---
 title: Data Science and Analytical Applications workload in Visual Studio | Microsoft Docs
+description: The Data Science and Analytical Applications workload in Visual Studio brings together Python, R, F#, and their respective runtime distributions including Anaconda.
 ms.custom: ""
-ms.date: 01/15/2018
+ms.date: 01/24/2018
 ms.reviewer: ""
 ms.suite: ""
 ms.technology: 

docs/rtvs/debugging.md renamed to docs/rtvs/debugging-r-in-visual-studio.md

@@ -1,7 +1,8 @@
 ---
 title: Debugging with the R Tools for Visual Studio | Microsoft Docs
+description: Visual Studio provides a full debugging experience for R including breakpoints, attach, call stack, and inspecting variables.
 ms.custom: ""
-ms.date: 06/29/2017
+ms.date: 01/24/2018
 ms.reviewer: ""
 ms.suite: ""
 ms.technology: 
@@ -19,7 +20,7 @@ ms.workload:
 
 # Debugging R in Visual Studio
 
-R Tools for Visual Studio (RTVS) integrates with the full debugging experience of Visual Studio (see [Debugging in Visual Studio](../debugger/debugging-in-visual-studio.md). This support includes breakpoints, attaching to running processes, inspecting and watching variables, and inspecting the call stack. This topic, then, explores those aspects of debugging that are unique to R and RTVS.
+R Tools for Visual Studio (RTVS) integrates with the full debugging experience of Visual Studio (see [Debugging in Visual Studio](../debugger/debugging-in-visual-studio.md). This support includes breakpoints, attaching to running processes, inspecting and watching variables, and inspecting the call stack. This article, then, explores those aspects of debugging that are unique to R and RTVS.
 
 Starting the debugger for the startup R file in an R project is the same as for other project types: use **Debug > Start Debugging**, the F5 key, or the **Source startup file** on the debug toolbar: 
 
@@ -49,10 +50,9 @@ add <- function(x, y) {
 
 Then you set a breakpoint on the `return` statement. Now, in the interactive window, entering `add(4,5)` stops the debugger on your breakpoint.
 
-
 ## Environment browser in the interactive window
 
-When you're stopped in the debugger, you're also stopped at the Environment Browser prompt in the [interactive window](interactive-repl.md). The prompt appears as `Browse[n]>` where n is a number.
+When you're stopped in the debugger, you're also stopped at the Environment Browser prompt in the [interactive window](interactive-repl-for-r-in-visual-studio.md). The prompt appears as `Browse[n]>` where n is a number.
 
 The Environment Browser supports a number of special commands:
 

docs/rtvs/code-editing.md renamed to docs/rtvs/editing-r-code-in-visual-studio.md

@@ -1,7 +1,8 @@
 ---
 title: Editing code with the R Tools for Visual Studio | Microsoft Docs
+description: Visual Studio provides a tailored editing experience for R while retaining all the features and the ability to use extensions.
 ms.custom: ""
-ms.date: 12/04/2017
+ms.date: 01/24/2018
 ms.reviewer: ""
 ms.suite: ""
 ms.technology: 
@@ -19,19 +20,9 @@ ms.workload:
 
 # Editing R code in Visual Studio
 
-R Tools for Visual Studio (RTVS) tailors the Visual Studio editing experience specifically for R. while retaining all the features and the ability to use extensions. (For example, if you prefer VIM key bindings, you can install the free [VsVim extension](https://visualstudiogallery.msdn.microsoft.com/59ca71b3-a4a3-46ca-8fe1-0e90e3f79329) from the Visual Studio gallery.)
+R Tools for Visual Studio (RTVS) tailors the Visual Studio editing experience specifically for R while retaining all the features and the ability to use extensions. (For example, if you prefer VIM key bindings, you can install the free [VsVim extension](https://visualstudiogallery.msdn.microsoft.com/59ca71b3-a4a3-46ca-8fe1-0e90e3f79329) from the Visual Studio gallery.)
 
-In this topic:
-
-- [Syntax highlighting](#syntax-highlighting)
-- [Editing and organizing code](#editing-and-organizing-code)
-- [Code navigation](#code-navigation)
-- [Sending code to the interactive window](#sending-code-to-the-interactive-window)
-- [Formatting code](#formatting-code)
-- [Inserting Roxygen comments](#inserting-roxygen-comments)
-- [Editor options](#editor-options)
-
-Also see the topics on [IntelliSense](code-intellisense.md), [linting](code-linting.md), [code snippets](code-snippets.md), and [R Markdown](rmarkdown.md).
+In addition to the features in this article, also see [IntelliSense](r-intellisense.md), [linting](linting-r-code.md), [code snippets](code-snippets-for-r.md), and [R Markdown](rmarkdown-with-r-in-visual-studio.md).
 
 ## Syntax highlighting
 
@@ -51,7 +42,7 @@ To change this behavior, see the **Advanced > Syntax check** setting under [edit
 
 ## Editing and organizing code
 
-As you type code, RTVS provides auto-completion as described on the [IntelliSense](code-intellisense.md) page. It also does automatic formatting such as completion of braces and parenthesis: 
+As you type code, RTVS provides auto-completion as described on the [IntelliSense](r-intellisense.md) page. It also does automatic formatting such as completion of braces and parenthesis: 
 
 ![Animation of inline formatting](media/editing-inline-formatting.gif)
 
@@ -83,7 +74,7 @@ This command opens a new editor window containing the source code for the functi
 
 ## Sending code to the interactive window
 
-Many developers like to write some code in the editor and then send that code to the [interactive window](interactive-repl.md) for immediate testing (also known as a Read-Evaluate-Print-Loop or REPL). Pressing Ctrl+Enter in the R editor sends the current line of code to the interactive window, then places the cursor on the next line. With Ctrl+Enter, then, you can effectively step through your code from the editor.
+Many developers like to write some code in the editor and then send that code to the [interactive window](interactive-repl-for-r-in-visual-studio.md) for immediate testing (also known as a Read-Evaluate-Print-Loop or REPL). Pressing Ctrl+Enter in the R editor sends the current line of code to the interactive window, then places the cursor on the next line. With Ctrl+Enter, then, you can effectively step through your code from the editor.
 
 You can also select code and press Ctrl+Enter to apply that entire selection. Alternately, right-click the selection and select **Execute in Interactive**.
 
@@ -117,7 +108,7 @@ RTVS provides a shortcut for generating [Roxygen](http://roxygen.org/) comments
 
 Editor-specific options are set through the **Tools > Options** command, navigating to **Text Editor > R**, or use the shortcut command **R Tools > Editor Options...**.
 
-Options on the **General**, **Scroll bars**, and **Tabs** tabs are not specific to R, but are rather general Visual Studio settings available for all languages but applied on a per-language basis. For details, see the following topics:
+Options on the **General**, **Scroll bars**, and **Tabs** tabs are not specific to R, but are rather general Visual Studio settings available for all languages but applied on a per-language basis. For details, see the following articles:
 
 - [Options, Text Editor, All Languages](../ide/reference/options-text-editor-all-languages.md)
 - [Track you code by customizing the scroll bar](../ide/how-to-track-your-code-by-customizing-the-scrollbar.md)

docs/rtvs/faq.md

@@ -1,5 +1,6 @@
 ---
 title: R Tools for Visual Studio FAQ | Microsoft Docs
+description: Frequently-asked questions on R in Visual Studio.
 ms.custom: ""
 ms.date: 12/04/2017
 ms.reviewer: ""
@@ -65,7 +66,7 @@ A. [CRAN R](https://cran.r-project.org/), [Microsoft R Client, and Microsoft Mac
 
 **Q. Where can I download these interpreters?**
 
-A. See [Installation](installation.md).
+A. See [Installation](installing-r-tools-for-visual-studio.md).
 
 Q **What is Microsoft R Server?**
 
@@ -87,7 +88,7 @@ A. Github maintains a master repository of recommended `.gitignore` files. You c
 
 Q. **What is Remote Services in Visual Studio?**
 
-A. Remote R Services for Visual Studio allows you to set up Windows or Linux machine and then connect to it from RTVS. See [Setting up Remote Workspaces](workspaces-remote-setup.md).
+A. Remote R Services for Visual Studio allows you to set up Windows or Linux machine and then connect to it from RTVS. See [Setting up Remote Workspaces](setting-up-remote-r-workspaces.md).
 
 Q. **Can RTVS connect to Microsoft R Server?**
 
@@ -99,7 +100,7 @@ A. Yes; the [Data Science VM - Windows 2016](https://azure.microsoft.com/service
 
 Q, **Can RTVS connect to a remote machine with R installed?**
 
-To execute R code on a remote machine there has to be some service listening to the requests, receiving code and sending results back to the client machine. This is what Remote R Services for Visual Studio do. See [Setting up Remote Workspaces](workspaces-remote-setup.md).
+To execute R code on a remote machine there has to be some service listening to the requests, receiving code and sending results back to the client machine. This is what Remote R Services for Visual Studio do. See [Setting up Remote Workspaces](setting-up-remote-r-workspaces.md).
 
 Q. **What is Remote Session?**
 

docs/rtvs/getting-started-help.md

@@ -1,7 +1,8 @@
 ---
-title: "Help Window in the R Tools for Visual Studio | Microsoft Docs"
+title: Help Window in the R Tools for Visual Studio | Microsoft Docs
+description: Help for R is integrated directly into the interactive window in Visual Studio through the ? command.
 ms.custom: ""
-ms.date: 06/29/2017
+ms.date: 001/24/2018
 ms.reviewer: ""
 ms.suite: ""
 ms.technology: 
@@ -26,7 +27,7 @@ Help for R is integrated directly into the interactive window in Visual Studio.
 > [!Tip]
 > The help window, like all others in Visual Studio, can be arranged and docked however you like. See [Customize window layouts in Visual Studio](../ide/customizing-window-layouts-in-visual-studio.md).
 >
-> To open help results in a browser, select the **R Tools > Options** menu and set the **R Help Browser** property to `External`. See [Options](options.md).
+> To open help results in a browser, select the **R Tools > Options** menu and set the **R Help Browser** property to `External`. See [Options](options-for-r-tools-in-visual-studio.md).
 
 To search help, use the `??` command followed by the search term. Use quotes if the search term contains spaces:
 
@@ -50,7 +51,7 @@ Developers often search the R documentation for help on function names, datasets
     ![Invoking help through the right click context menu](media/help-right-click.png)
 
 > [!Tip]
-> To open integrated help in a browser, select **R Tools > Options** and set **F1 Web Browser** to `External`. See [Options](options.md).
+> To open integrated help in a browser, select **R Tools > Options** and set **F1 Web Browser** to `External`. See [Options](options-for-r-tools-in-visual-studio.md).
 
 ## Integrated StackOverflow search
 
@@ -62,4 +63,4 @@ You can change the appended scoping string, `R site:stackoverflow`, through the
 
 ![Changing the F1 Web search string option](media/options-dialog.png)
 
-If you prefer to show results in a browser, change the **F1 Web Browser** option as described on [Options](options.md).
+If you prefer to show results in a browser, change the **F1 Web Browser** option as described on [Options](options-for-r-tools-in-visual-studio.md).

docs/rtvs/getting-started-samples.md

@@ -1,7 +1,8 @@
 ---
-title: "Sample projects for R Tools for Visual Studio | Microsoft Docs"
+title: Sample projects for R Tools for Visual Studio | Microsoft Docs
+description: An index of a collection of samples to get started with R and Visual Studio.
 ms.custom: ""
-ms.date: 06/29/2017
+ms.date: 01/24/2018
 ms.reviewer: ""
 ms.suite: ""
 ms.technology: