Merge pull request #2088 from MicrosoftDocs/master

5/23 AM Publish

Author: Taojunshen

docs/TOC.md

@@ -492,5 +492,6 @@
 ### [Distributable code](/visualstudio/productinfo/2017-redistribution-vs?context=visualstudio/default)
 ### [Support lifecycle and servicing](/visualstudio/productinfo/vs-servicing-vs?context=visualstudio/default)
 ## [How to Report a Problem with Visual Studio](ide/how-to-report-a-problem-with-visual-studio-2017.md)
+## [Visual Studio Experience Improvement Program](ide/visual-studio-experience-improvement-program.md)
 ## [Resources for Troubleshooting IDE Errors](ide/reference/resources-for-troubleshooting-integrated-development-environment-errors.md)
 ## [Talk to Us](ide/talk-to-us.md)

docs/ide/media/experience-improvement-program.png

@@ -1,6 +1,6 @@
 ---
-title: IntelliCode FAQ
-ms.date: 05/07/2018
+title: IntelliCode questions and answers
+ms.date: 05/22/2018
 ms.prod: visual-studio-dev15
 ms.technology: vs-ide-general
 ms.topic: conceptual
@@ -31,6 +31,10 @@ Visual Studio IntelliCode is a range of capabilities that offers new productivit
 
 Developers can [download an experimental extension](https://go.microsoft.com/fwlink/?linkid=872707) for Visual Studio 2017 version 15.7 and later. The extension provides enhanced IntelliSense that predicts the most likely correct API for the developer to use, rather than just presenting an alphabetical list of members. It uses the developer's current code context and patterns to provide this dynamic list. We'll update the extension with more capabilities in the coming months.
 
+## Q. Are there other features coming to the Visual Studio IntelliCode extension? What about editorconfig generation?
+
+We're actively working on a number of capabilities that we're excited to share publicly as they become available. We demonstrated an early, internal version of a tool that infers editorconfig settings for code style and formatting in C# at Microsoft Build 2018. It's not in the experimental extension yet, but we plan to make it available there soon. You can sign up for news and updates at [https://aka.ms/intellicode](https://aka.ms/intellicode) to be the first to know when we have new capabilities available.
+
 ## Q: What makes “AI-assisted IntelliSense” powered by IntelliCode better than regular IntelliSense?
 
 With IntelliCode, the completion list suggests the most likely correct API for a developer to use, rather than presenting a simple alphabetical list of members. It uses the developer's current code context, and patterns based on 2000 high quality, open-source projects on GitHub each with over 100 stars, to provide this dynamic list. The results form a model that predicts the most likely and most relevant API calls.
@@ -44,7 +48,7 @@ We’ve been using IntelliCode’s recommendations internally at Microsoft for s
 
 ## Q. What's the future of IntelliCode?
 
-We're exploring a wide range of ways to improve developer productivity using AI and other advanced techniques. At Build 2018, we showed an early view of some of the scenarios where we think AI could assist developers, but there are so many more! We're interested in learning from developers that experiment with what we've shown, so sign up for news and updates at [https://aka.ms/intellicode](https://aka.ms/intellicode).
+We're exploring a wide range of ways to improve developer productivity using AI and other advanced techniques. At Microsoft Build 2018, we showed an early view of some of the scenarios where we think AI could assist developers, but there are so many more! We're interested in learning from developers that experiment with what we've shown, so sign up for news and updates at [https://aka.ms/intellicode](https://aka.ms/intellicode).
 
 ## Q. How much does it cost?
 
@@ -58,19 +62,25 @@ IntelliCode's AI-assisted IntelliSense is currently in its first experimental pr
 
 The experience was shown at Build 2018 in Visual Studio 2017 on a C# codebase. However, we look forward to expanding IntelliCode to more languages and tools in the Visual Studio family in the future.
 
+## Q. <a name="whynointellisense"/> I can't see the IntelliCode suggestions in my C# editing experience - what's happening?
+
+IntelliCode suggestions appear in the standard Visual Studio IntelliSense experience for C#. Extensions that override that experience prevent the IntelliCode "starred" suggestions from appearing at the top of the list. You can verify if extensions are causing this behavior by turning them off and then trying IntelliSense again.
+
+If this doesn't solve the problem for you, please report your issue via the Visual Studio [Report a Problem](https://docs.microsoft.com/en-us/visualstudio/ide/how-to-report-a-problem-with-visual-studio-2017) feature, and mention IntelliCode in your report.
+
 ## Q. What release of Visual Studio do I need to run this extension?
 
 The Visual Studio IntelliCode extension is supported on Visual Studio 2017 version 15.7 preview 5 and later (all SKUs). Installation of the extension halts with "This extension is not installable on any currently installed products." if you don't have the minimum required version installed.
 
 ## Q. Is this experience only available in English?
 
-IntelliCode is a preview extension today, and we are eager to understand how useful these capabilities are for a broad set of customers. When we take IntelliCode out of preview, we'll certainly consider which locale or language to support first, and how it is packaged, based on your feedback. 
+IntelliCode is a preview extension today, and we are eager to understand how useful these capabilities are for a broad set of customers. When we take IntelliCode out of preview, we'll certainly consider which locale or language to support first, and how it is packaged, based on your feedback.
 
 ## <a name="privacy"/> Q: What about privacy? Are you sending my code to the cloud? What customer data is being sent to Microsoft?
 
 Developers are invited to experience Visual Studio IntelliCode today as an experimental preview extension. The purpose of the extension is to enable developers to test IntelliCode's capabilities and to provide feedback to the product team.
 
-We capture some anonymized usage and error-reporting data from the extension to help improve the product. No user-defined code is sent to Microsoft, but we collect information about your use of the IntelliCode results. The data only includes open-source and .NET types and members that you selected from IntelliCode's suggested list. Developers can opt out of Visual Studio data collection, which turns off data collection for the IntelliCode extension too. From the menu bar, select **Help** > **Send Feedback** > **Settings**. In the **Visual Studio Experience Improvement Program** dialog, select **No, I would not like to participate** and then select **OK**.
+We capture some anonymized usage and error-reporting data from the extension to help improve the product. No user-defined code is sent to Microsoft, but we collect information about your use of the IntelliCode results. The data only includes open-source and .NET types and members that you selected from IntelliCode's suggested list. Developers can opt out of the [Visual Studio Experience Improvement Program](../../ide/visual-studio-experience-improvement-program.md), which turns off data collection for the IntelliCode extension too. From the menu bar, select **Help** > **Send Feedback** > **Settings**. In the **Visual Studio Experience Improvement Program** dialog, select **No, I would not like to participate** and then select **OK**.
 
 The IntelliCode extension may periodically ask the developer to complete a survey, which again is anonymized. Users can sign up for news and a future private preview, but are not currently required to do so to use the experimental extension.
 

docs/ide/not-in-toc/intellicode-faq.md

@@ -0,0 +1,60 @@
+---
+title: Customer Experience Improvement Program
+description: "Find out how to manage privacy settings in Visual Studio."
+ms.date: 05/21/2018
+ms.prod: visual-studio-dev15
+ms.technology: vs-acquisition
+ms.prod: visual-studio-dev15
+ms.topic: conceptual
+author: PoulChapman
+ms.author: tglee
+manager: douge
+ms.workload:
+  - "multiple"
+---
+# Visual Studio Customer Experience Improvement Program
+
+The Visual Studio Customer Experience Improvement Program (VSCEIP) is a program designed to help Microsoft improve Visual Studio over time. This program collects information about computer hardware and how people use Visual Studio, without interrupting users in their tasks at the computer. The information that's collected helps Microsoft identify which features to improve. This document covers how to opt in or out of the VSCEIP.
+
+## Opt in or out
+
+The VSCEIP is turned on by default. You can turn it off, or back on again, by following these instructions:
+
+1. Start Visual Studio.
+
+1. From the **Help** menu, point to **Send Feedback**, and then select **Settings**.
+
+   The **Visual Studio Experience Improvement Program** dialog box opens.
+
+1. To opt out, select **No, I would not like to participate**, and then select **OK**.
+   To opt in, select **Yes, I am willing to participate**, and then select **OK**.
+
+   ![Visual Studio Experience Improvement Program dialog](media/experience-improvement-program.png)
+
+### Registry settings
+
+If you install the [Build Tools for Visual Studio](https://www.visualstudio.com/downloads/#build-tools-for-visual-studio-2017), you must update the registry to configure the VSCEIP. Enterprise customers can construct a group policy to opt in or out of the VSCEIP by setting a registry-based policy.
+
+[!INCLUDE [gdpr-hybrid-note](../misc/includes/gdpr-hybrid-note.md)]
+
+The relevant registry key and settings are as follows:
+
+Key = **HKEY_CURRENT_USER\SOFTWARE\Microsoft\VSCommon\15.0\SQM**
+
+Entry = OptIn
+
+Value = (DWORD)
+- **0** is opted out (turn off the VSCEIP)
+- **1** is opted in (turn on the VSCEIP)
+
+> [!CAUTION]
+> Incorrectly editing the registry may severely damage your system. Before making changes to the registry, you should back up any valued data on the computer. You can also use the **Last Known Good Configuration** startup option if you encounter problems after manual changes have been applied.
+
+For more information about the information collected, processed, or transmitted by the VSCEIP, see the [Microsoft Privacy Statement](https://privacy.microsoft.com/privacystatement).
+
+## See also
+
+* [Talk to us](../ide/talk-to-us.md)
+* [How to report a problem with Visual Studio](../ide/how-to-report-a-problem-with-visual-studio-2017.md)
+* [Visual Studio Developer Community](https://developercommunity.visualstudio.com/)
+* [Microsoft Privacy Statement](https://privacy.microsoft.com/privacystatement)

docs/ide/visual-studio-experience-improvement-program.md

@@ -0,0 +1,12 @@
+---
+title: include file
+ms.date: 04/24/2018
+ms.prod: visual-studio-dev15
+ms.topic: include
+author: eross-msft
+ms.author: lizross
+---
+> [!NOTE]
+> If you’re interested in viewing or deleting personal data, please see [Azure data subject requests for the GDPR](/microsoft-365/compliance/gdpr-dsr-azure). If you’re looking for general information about GDPR, see the GDPR section of the [Service Trust Portal](https://servicetrust.microsoft.com/ViewPage/GDPRGetStarted).
+
+[//]: # (5/22/2018: Even though this file may be orphaned, do not delete it.)

docs/misc/includes/gdpr-dsr-and-stp-note.md

@@ -0,0 +1,12 @@
+---
+title: include file
+ms.date: 05/01/2018
+ms.prod: visual-studio-dev15
+ms.topic: include
+author: eross-msft
+ms.author: lizross
+---
+> [!NOTE]
+> If you’re interested in viewing or deleting personal data, please review Microsoft's guidance at [Windows Data Subject Requests for the GDPR](/microsoft-365/compliance/gdpr-dsr-windows). If you’re looking for general information about GDPR, see the GDPR section of the [Service Trust Portal](https://servicetrust.microsoft.com/ViewPage/GDPRGetStarted).
+
+[//]: # (5/22/2018: Even though this file may be orphaned, do not delete it.)

docs/misc/includes/gdpr-hybrid-note.md

@@ -0,0 +1,12 @@
+---
+title: include file
+ms.date: 04/24/2018
+ms.prod: visual-studio-dev15
+ms.topic: include
+author: eross-msft
+ms.author: lizross
+---
+> [!NOTE]
+> This article provides steps for how to delete personal data from the device or service, and can be used to support your obligations under the GDPR. If you’re looking for general info about GDPR, see the GDPR section of the [Service Trust Portal](https://servicetrust.microsoft.com/ViewPage/GDPRGetStarted).
+
+[//]: # (5/22/2018: Even though this file may be orphaned, do not delete it.)

docs/misc/includes/gdpr-intro-sentence.md

@@ -274,4 +274,4 @@ Answer: When Django looks for a template referred to in the `render` function, i
 - [Writing your first Django app, part 1 - views](https://docs.djangoproject.com/en/2.0/intro/tutorial01/#write-your-first-view) (docs.djangoproject.com)
 - For more capabilities of Django templates, such as includes and inheritance, see [The Django template language](https://docs.djangoproject.com/en/2.0/ref/templates/language/) (docs.djangoproject.com)
 - [Regular expression training on inLearning](https://www.linkedin.com/learning/topics/regular-expressions) (LinkedIn)
-- Tutorial source code on GitHub: [Microsoft/python-sample-vs-learning-django](https://github.com/Microsoft/python-sample-vs-learning-django)
+- Tutorial source code on GitHub: [Microsoft/python-sample-vs-learning-django](https://github.com/Microsoft/python-sample-vs-learning-django)

docs/python/learn-django-in-visual-studio-step-02-create-an-app.md

@@ -1,7 +1,7 @@
 ---
 title: Manage Python environments and interpreters
 description: Use the Python Environments window to manage global, virtual, and conda environments, installing Python interpreters and packages, and assigning environments to Visual Studio projects.
-ms.date: 05/07/2018
+ms.date: 05/22/2018
 ms.prod: visual-studio-dev15
 ms.technology: vs-python
 ms.topic: conceptual

docs/python/managing-python-environments-in-visual-studio.md

@@ -1,7 +1,7 @@
 ---
 title: Python environments window reference
 description: Details on each of the tabs that appear in the Python Environments window in Visual Studio.
-ms.date: 05/07/2018
+ms.date: 05/22/2018
 ms.prod: visual-studio-dev15
 ms.technology: vs-python
 ms.topic: conceptual
@@ -71,7 +71,7 @@ If available, contains details as described in the table below. If this tab isn'
 
 *Also labeled "pip" in earlier versions.*
 
-Manages the packages installed in the environment using pip, allowing you to also search for and install new ones (including any dependencies). In Visual Studio 2017 version 15.7 and later, a **Packages (Conda)** option appears which uses the conda package manager instead. (If you don't see that choice, set the option  **Tools** > **Options** > **Python** > **Experimental** > **Use conda package manager when available (instead of pip)** and restart Visual Studio.)
+Manages the packages installed in the environment using pip, allowing you to also search for and install new ones (including any dependencies). In Visual Studio 2017 version 15.7 and later, a **Packages (Conda)** tab appears which uses the conda package manager instead. (If you don't see that choice, set the option  **Tools** > **Options** > **Python** > **Experimental** > **Use conda package manager when available (instead of pip)** and restart Visual Studio.)
 
 Packages that are already installed appear with controls to update (an up arrow) and uninstall (the X in a circle) the package:
 
@@ -81,7 +81,13 @@ Entering a search term filters the list of installed packages as well as package
 
 ![Python environments packages tab with a search on "num"](media/environments-pip-tab.png)
 
-You can also directly enter any `pip install` command in the search box, including flags such as `--user` or `--no-deps`.
+As you can see in the image above, the search results show a number of packages that match the search term; the first entry in the list, however, is a command to run `pip install <name>` directly. If you're on the **Packages (Conda)** tab, you instead see `conda install <name>`:
+
+![Conda packages tab showing a conda install command](media/environments-conda-tab-install.png)
+
+In both cases, you can customize the install by adding arguments in the search box after the name of the package. When you include arguments, the search results shows `pip install` or `conda install` followed by the contents of the search box:
+
+![Using arguments on pip and conda install commands](media/environments-pip-tab-arguments.png)
 
 Installing a package creates subfolders within the environment's `Lib` folder on the file system. For example, if you have Python 3.6 installed in `c:\Python36`, packages are installed in `c:\Python36\Lib`; if you have Anaconda3 installed in `c:\Program Files\Anaconda3` then packages are installed in `c:\Program Files\Anaconda3\Lib`.
 

docs/python/media/environments-conda-tab-install.png

@@ -32,7 +32,7 @@ ms.workload:
 ## Workflows in SharePoint  
  When you add a workflow to a SharePoint library or list, you enforce a business process on all items in the library or list. A workflow describes the actions that the system or users must perform on each item, such as sending the item to be edited and then reviewed. These actions, known as *activities*, are the building blocks of the workflow.  
 
- You can create SharePoint workflows in [!INCLUDE[vsprvs](../sharepoint/includes/vsprvs-md.md)] and deploy them to a SharePoint Web site. After a workflow is deployed to SharePoint, you associate it with a library or list. It can then be started automatically, by a process, or manually, by a user. For more information about workflow operation, see [Using workflows to manage processes](http://go.microsoft.com/fwlink/?LinkId=79757).  
+ You can create SharePoint workflows in [!INCLUDE[vsprvs](../sharepoint/includes/vsprvs-md.md)] and deploy them to a SharePoint Web site. After a workflow is deployed to SharePoint, you associate it with a library or list. It can then be started automatically, by a process, or manually, by a user. For more information about workflow operation, see [Develop SharePoint workflows using Visual Studio](https://docs.microsoft.com/sharepoint/dev/general-development/develop-sharepoint-workflows-using-visual-studio).  
 
 ## Creating Custom SharePoint Workflows  
  Two SharePoint workflow projects are available to you in [!INCLUDE[vsprvs](../sharepoint/includes/vsprvs-md.md)]: **Sequential Workflow** and **State Machine Workflow**.