Merge pull request #1561 from kraigb/kraigb-pythonfeedback

Address a few customer comments

Author: Lisaco88

docs/python/debugging-python-in-visual-studio.md

@@ -127,7 +127,7 @@ The **Debug > Windows > Exception Settings** menu command brings up a window in
 
 The checkbox for each exception controls whether the debugger *always* breaks when it is raised. Check this box when you want to break more often for a particular exception.
 
-By default, most exceptions break when an exception handler cannot found in the source code. To change this behavior, right-click any exception and check or uncheck **Continue When Unhandled in User Code**. Clear this box when you want to break less often for an exception.
+By default, most exceptions break when an exception handler cannot be found in the source code. To change this behavior, right-click any exception and check or uncheck **Continue When Unhandled in User Code**. Clear this box when you want to break less often for an exception.
 
 To configure an exception that does not appear in this list, click the **Add** button to add it. The name must match the full name of the exception.
 
@@ -156,7 +156,7 @@ By default, the debugger starts your program with the standard Python launcher,
 | Interpreter Path | Overrides the path associated with the current environment.  value may be useful for launching your script with a non-standard interpreter. |
 | Environment Variables | In this multi-line text box, add entries of the form `NAME=VALUE`. Because this setting is applied last, on top of any existing global environment variables, and after `PYTHONPATH` is set according to the Search Paths setting, it can be used to manually override any of those other variables. |
 
-<a name="the-debug-interactive-window"</a>
+<a name="the-debug-interactive-window"></a>
 
 ## Immediate and interactive windows
 

docs/python/formatting-python-code.md

@@ -26,9 +26,13 @@ Visual Studio lets you quick reformat code to match pre-configured formatting op
 - To format a selection: select **Edit > Advanced > Format Selection** or press Ctrl+E,F.
 - To format the whole file: select **Edit > Advanced > Format Document** or press Ctrl+E,D.
 
-Options are set through **Tools > Options > Text Editor > Python > Formatting** and its nested tabs, and by default are set to match a superset of the [PEP 8 style guide](http://www.python.org/dev/peps/pep-0008/). The **General** tab determines when formatting is applied; settings the other three tabs are described in this article.
+Options are set through **Tools > Options > Text Editor > Python > Formatting** and its nested tabs. You need to select **Show all settings** for these options to appear:
 
-[Python support in Visual Studio](installing-python-support-in-visual-studio.md) also adds the useful [Fill Comment Paragraph](#fill-comment-paragraph-command) command to the **Edit > Advanced** menu as described that follow.
+![Python formatting options in Visual Studio](media/options-editor-formatting.png)
+
+Formatting options by default are set to match a superset of the [PEP 8 style guide](http://www.python.org/dev/peps/pep-0008/). The **General** tab determines when formatting is applied; settings for the other three tabs are described in this article.
+
+[Python support in Visual Studio](installing-python-support-in-visual-studio.md) also adds the useful [Fill Comment Paragraph](#fill-comment-paragraph-command) command to the **Edit > Advanced** menu as described in a later section.
 
 ## Spacing
 
@@ -132,4 +136,4 @@ changes to:
 ```python
 # This is a very long long long long long long long long long long long long
 # long long long long long long long comment
-```
+```

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

@@ -56,7 +56,7 @@ A new project is always associated with the default global Python environment. T
 
 ![Activating an environment for a Python project](media/projects-activate-environment.png)
 
-<a name="project-types"</a>
+<a name="project-types"></a>
 
 ## Project templates
 

docs/python/media/options-editor-formatting.png

@@ -51,7 +51,7 @@ As you use interactive windows in your everyday workflow, you likely develop hel
 
 Startup scripts contain code that the interactive window loads and runs automatically, including imports, function definitions, and literally anything else. Such scripts are referenced in two ways:
 
-1. When you install an environment, Visual Studio creates a folder `Documents\Visual Studio 2017\Python Scripts\<environment>` where &lt;environment&gt' matches the name of the environment. You can easily navigate to the environment-specific folder with the **Explore interactive scripts** command. When you start the interactive window for that environment, it loads and runs whatever `.py` files are found here in alphabetical order.
+1. When you install an environment, Visual Studio creates a folder `Documents\Visual Studio 2017\Python Scripts\<environment>` where &lt;environment&gt; matches the name of the environment. You can easily navigate to the environment-specific folder with the **Explore interactive scripts** command. When you start the interactive window for that environment, it loads and runs whatever `.py` files are found here in alphabetical order.
 
 1. The **Scripts** control in **Tools > Options > Python Tools > Interactive Windows** tab (see [Interactive windows options](python-support-options-and-settings-in-visual-studio.md#interactive-windows-options)) is intended to specify an additional folder for startup scripts that are loaded and run in all environments. However, this feature doesn't work at present.
 

docs/python/python-environments-window-tab-reference.md

@@ -27,7 +27,7 @@ The Visual Studio *interactive window* for Python provides a rich read-evaluate-
 
 1. Open the interactive window by right-clicking the project's Python environment in Solution Explorer (such as "Python 3.6 (32-bit)" shown in an earlier graphic) and selecting **Open Interactive Window**. You can alternately select **View > Other Windows > Python Interactive Windows** from the main Visual Studio menu.
 
-1. The interactive window opens below the editor with the usual `>>>` Python REPL prompt. Oftentimes you want to make the interactive window larger, which you can do by dragging the separator between the two windows:
+1. The interactive window opens below the editor with the standard `>>>` Python REPL prompt. The **Environment** drop-down list allows you to select a specific interpreter to work with. Oftentimes you also want to make the interactive window larger, which you can do by dragging the separator between the two windows:
 
     ![Python interactive window and dragging to resize](media/vs-getting-started-python-11-interactive1b.png)