Merge pull request #13074 from cwebster-99/refactored-yodel

Addressing doc bugs for PTVS content

Author: prmerger-automator[bot]

docs/python/configure-web-apps-for-iis-windows.md

@@ -29,7 +29,7 @@ The `web.config` file for your Python application instructs the IIS web server (
 
 If your project does not already contain a `web.config` file, you can add one by right-clicking the project directory, selecting **Add > New Item** and searching for `web.config` or creating a blank `web.config` XML file.
 
-### Configure the HttpPlatformHandler
+### Option 1 : Configure the HttpPlatformHandler
 
 The HttpPlatform module passes socket connections directly to a standalone Python process. This pass-through allows you to run any web server you like, but it requires a startup script that runs a local web server. This approach is commonly done by using a Python web framework, such as Flask or Django. You specify the script in the `<httpPlatform>` element of the `web.config` file. The `processPath` attribute points to the site extension's Python interpreter. The `arguments` attribute points to your startup script that runs a local web server, in this case `runserver.py`, and any arguments you want to provide:
 
@@ -56,12 +56,12 @@ The HttpPlatform module passes socket connections directly to a standalone Pytho
 
 In this example, the `HTTP_PLATFORM_PORT` environment variable contains the port that your local server should listen on for connections from `localhost`. This example also shows how to create another environment variable, `SERVER_PORT`. You can create and assign environment variables as needed.
 
-### Configure the FastCGI handler
+### Option 2 : Configure the FastCGI handler
 
-FastCGI is an interface that works at the request level. IIS receives incoming connections and forwards each request to a WSGI app running in one or more persistent Python processes.
+Alternatively, you can use FastCGI to configure your apps. FastCGI is an interface that works at the request level. IIS receives incoming connections and forwards each request to a WSGI app running in one or more persistent Python processes.
 
 > [!NOTE]
-> We recommend using **HttpPlatformHandler** to configure your apps, as the [WFastCGI](https://pypi.org/project/wfastcgi/) project is no longer maintained. 
+> Although you can set your project up using FastCGI, we recommend using **HttpPlatformHandler** to configure your apps, as the [WFastCGI](https://pypi.org/project/wfastcgi/) project is no longer maintained and may result in bugs. 
 
 To use FastCGI, first install and configure the wfastcgi package as described in [pypi.org/project/wfastcgi/](https://pypi.io/project/wfastcgi).
 

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

@@ -91,6 +91,8 @@ The following table summarizes these commands and provides the keyboard shortcut
 
 | Command | Shortcut | Description |
 | --- | --- | --- |
+| **Stop**            | **Shift + F5**                     | Stop the debugging session. |
+| **Restart**            | **Ctrl + Shift + F5**                     | Restart the current debugging session. |
 | **Continue**            | **F5**                     | Run code until you reach the next breakpoint. |
 | **Step Into**           | **F11**                    | Run the next statement and stop. If the next statement is a call to a function, the debugger stops at the first line of the called function. |
 | **Step Over**           | **F10**                    | Run the next statement, including making a call to a function (running all its code) and applying any return value. This command allows you to easily skip functions that you don't need to debug. |

docs/python/installing-python-support-in-visual-studio.md

@@ -20,6 +20,9 @@ Python support is available only on Visual Studio for Windows. On Mac and Linux,
 
 - Visual Studio on Windows. To install the product, follow the steps in [Install Visual Studio](../install/install-visual-studio.md).
 
+> [!NOTE]
+> You also need a Python interpreter installed in order to work with Python in Visual Studio. We recommend installing one from [python.org](https://www.python.org/downloads/) or Anaconda. For more information on Python interpreters, see [Installing Python Interpreters](installing-python-interpreters.md). 
+
 ## Download and install the Python workload
 
 Complete the following steps to download and install the Python workload.

docs/python/profiling-python-code-in-visual-studio.md

@@ -29,7 +29,7 @@ Visual Studio for Mac isn't supported. For more information, see [What's happeni
 
 ## Use profiler with CPython-based interpreter
 
-When you profile a Python application, Visual Studio collects data for the lifetime of the process. 
+When you profile a Python application, Visual Studio collects data for the lifetime of the process, measured in milliseconds (ms).  
 
 Follow these steps to start working with the profiling features in Visual Studio: