Skip to content

Commit 0779655

Browse files
authored
Merge pull request #5713 from tcmetzger/WTD_Block-22
Write the Docs - Updates for Block 22
2 parents 54633ec + 6fd69e8 commit 0779655

18 files changed

+59
-59
lines changed

docs/python/publish-to-app-service-windows.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ The publishing process differs between Visual Studio 2017 and later and Visual S
2929

3030
For this walkthrough, you need a web app project based on the Bottle, Flask, or Django frameworks. If you don't yet have a project and would like to try the publishing process, create a simple test project as follows:
3131

32-
1. In Visual Studio, select **File > New > Project**, search for "Bottle", select the **Bottle Web Project**, specify and name and a path for the project, click **OK**. (The Bottle template is included with the Python development workload; see [Installation](installing-python-support-in-visual-studio.md).)
32+
1. In Visual Studio, select **File > New > Project**, search for "Bottle", select the **Bottle Web Project**, specify and name and a path for the project, select **OK**. (The Bottle template is included with the Python development workload; see [Installation](installing-python-support-in-visual-studio.md).)
3333

3434
1. Follow the prompts to install external packages, selecting **Install into a virtual environment** and your preferred base interpreter for the virtual environment. You typically match this choice with the version of Python installed on App Service.
3535

@@ -74,7 +74,7 @@ If desired, you can also install the `bottle` package using the process in those
7474

7575
Publishing to Azure App Service from Visual Studio 2017 and later copies only the files in your project to the server. It's necessary, therefore, to create the necessary files to configure the server environment.
7676

77-
1. In Visual Studio **Solution Explorer**, right-click the project and select **Add > New Item...**. In the dialog that appears, selecting the "Azure web.config (Fast CGI)" template and select OK. This creates a `web.config` file in your project root.
77+
1. In Visual Studio **Solution Explorer**, select and hold (or right-click) the project and select **Add > New Item...**. In the dialog that appears, selecting the "Azure web.config (Fast CGI)" template and select OK. This creates a `web.config` file in your project root.
7878

7979
1. Modify the `PythonHandler` entry in `web.config` so that the path matches the Python installation on the server (see [IIS Configuration Reference](https://www.iis.net/configreference) (iis.net) for exact details). For example, for Python 3.6.1 x64 the entry should appear as follows:
8080

@@ -128,9 +128,9 @@ Publishing to Azure App Service from Visual Studio 2017 and later copies only th
128128

129129
Note that when the array is empty, Django automatically allows 'localhost', but adding your production URL removes that capabilities. For this reason you might want to maintain separate development and production copies of `settings.py`, or use environment variables to control the run time values.
130130

131-
1. In **Solution Explorer**, expand the folder named the same as your project, right-click the `static` folder, select **Add > New Item...**, select the "Azure static files web.config" template, and select **OK**. This action creates another `web.config` in the `static` folder that disables Python processing for that folder. This configuration sends requests for static files to the default web server rather than using the Python application.
131+
1. In **Solution Explorer**, expand the folder named the same as your project, select and hold (or right-click) the `static` folder, select **Add > New Item...**, select the "Azure static files web.config" template, and select **OK**. This action creates another `web.config` in the `static` folder that disables Python processing for that folder. This configuration sends requests for static files to the default web server rather than using the Python application.
132132

133-
1. Save your project, then in Visual Studio **Solution Explorer**, right-click the project and select **Publish**.
133+
1. Save your project, then in Visual Studio **Solution Explorer**, select and hold (or right-click) the project and select **Publish**.
134134

135135
![Publish command on a project's context menu](media/template-web-publish-command.png)
136136

@@ -180,7 +180,7 @@ Publishing to Azure App Service from Visual Studio 2017 and later copies only th
180180
> [!Note]
181181
> A short video of this process can be found on [Visual Studio Python Tutorial: Building a Website](https://www.youtube.com/watch?v=FJx5mutt1uk&list=PLReL099Y5nRdLgGAdrb_YeTdEnd23s6Ff&index=6) (youtube.com, 3m10s).
182182

183-
1. In **Solution Explorer**, right-click the project select **Publish**.
183+
1. In **Solution Explorer**, select and hold (or right-click) the project select **Publish**.
184184

185185
1. In the **Publish** dialog, select **Microsoft Azure App Service**:
186186

docs/python/python-interactive-repl-in-visual-studio.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ Entering `dir()` in a scope displays valid identifiers in that scope, including
9696

9797
## Send to Interactive command
9898

99-
In addition to working within the **Interactive** window directly, you can select code in the editor, right-click, and choose **Send to Interactive** or press **Ctrl**+**Enter**.
99+
In addition to working within the **Interactive** window directly, you can select code in the editor, select and hold (or right-click), and choose **Send to Interactive** or press **Ctrl**+**Enter**.
100100

101101
![Send to interactive menu command](media/interactive-send-to.png)
102102

docs/python/python-web-application-project-templates.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ Microsoft Azure Cloud Services *does* support the *requirements.txt* file. See [
7676

7777
## Debugging
7878

79-
When a web project is started for debugging, Visual Studio starts a local web server on a random port and opens your default browser to that address and port. To specify additional options, right-click the project, select **Properties**, and select the **Web Launcher** tab:
79+
When a web project is started for debugging, Visual Studio starts a local web server on a random port and opens your default browser to that address and port. To specify additional options, select and hold (or right-click) the project, select **Properties**, and select the **Web Launcher** tab:
8080

8181
![Web launcher properties for the generic web template](media/template-web-launcher-properties.png)
8282

docs/python/quickstart-05-python-visual-studio-open-folder.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Once you've [installed Python support in Visual Studio 2019](installing-python-s
3838

3939
![A view of hidden folders in Solution Explorer](media/quickstart-open-folder/05-view-hidden-folders.png)
4040

41-
1. To run the code, you first need to identify the startup or primary program file. In the example shown here, the startup file *contemplate-koans.py*. Right-click that file and select **Set as Startup Item**.
41+
1. To run the code, you first need to identify the startup or primary program file. In the example shown here, the startup file *contemplate-koans.py*. Select and hold (or right-click) that file and select **Set as Startup Item**.
4242

4343
![Setting a startup item in Solution Explorer](media/quickstart-open-folder/06-set-as-startup-item-command.png)
4444

@@ -63,7 +63,7 @@ By default, Visual Studio runs a Python project opened as a folder in the root o
6363

6464
In such cases, you must also add a line to the launch configuration JSON file to specify the working directory:
6565

66-
1. Right-click the Python (*.py*) startup file in **Solution Explorer** and select **Debug and Launch Settings**.
66+
1. Select and hold (or right-click) the Python (*.py*) startup file in **Solution Explorer** and select **Debug and Launch Settings**.
6767

6868
![The Debug and Launch Settings command for a Python file](media/quickstart-open-folder/09-debug-launch-settings-menu-command.png)
6969

@@ -72,7 +72,7 @@ In such cases, you must also add a line to the launch configuration JSON file to
7272
![The Debug and Launch Settings command for a Python file](media/quickstart-open-folder/10-select-debugger.png)
7373

7474
> [!Note]
75-
> If you don't see **Default** as a choice, be sure that you right-clicked a Python *.py* file when selecting the **Debug and Launch Settings** command. Visual Studio uses the file type to determine while debugger options to display.
75+
> If you don't see **Default** as a choice, be sure that you chose a Python *.py* file when selecting the **Debug and Launch Settings** command. Visual Studio uses the file type to determine which debugger options to display.
7676
7777
1. Visual Studio opens a file named *launch.vs.json*, which is located in the hidden *.vs* folder. This file describes the debugging context for the project. To specify a working directory, add a value for `"workingDirectory"`, as in `"workingDirectory": "python3"` for python-koans example:
7878

docs/python/refactoring-python-code.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Visual Studio provides several commands for automatically transforming and clean
2323

2424
## Rename
2525

26-
1. Right-click the identifier you wish to rename and select **Rename**, or place the caret in that identifier and select the **Edit** > **Refactor** > **Rename** menu command (**F2**).
26+
1. Select and hold (or right-click) the identifier you wish to rename and select **Rename**, or place the caret in that identifier and select the **Edit** > **Refactor** > **Rename** menu command (**F2**).
2727
2. In the **Rename** dialog that appears, enter the new name for the identifier and select **OK**:
2828

2929
![Rename prompt for new identifer name](media/code-refactor-rename-1.png)
@@ -66,7 +66,7 @@ Finally, if something would normally be excluded but has other values that would
6666

6767
When writing code, it's easy to end up with `import` statements for modules that aren't being used at all. Because Visual Studio analyzes your code, it can automatically determine whether an `import` statement is needed by looking at whether the imported name is used within the scope below where the statement occurs.
6868

69-
Right-click anywhere in the editor and select **Remove Imports**, which gives you options to remove from **All Scopes** or just the **Current Scope**:
69+
Use select and hold (or right-click) anywhere in the editor and select **Remove Imports**, which gives you options to remove from **All Scopes** or just the **Current Scope**:
7070

7171
![Remove imports menu](media/code-refactor-remove-imports-1.png)
7272

docs/python/search-paths.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Visual Studio ignores the search path environment variable, however, even when t
2424

2525
Visual Studio thus provides a means to specify search paths directly in both environments and projects. Code that you run or debug in Visual Studio receives search paths in the value of `PYTHONPATH` (and other equivalent variables). By adding search paths, Visual Studio inspects the libraries in those locations and builds IntelliSense databases for them when needed (Visual Studio 2017 version 15.5 and earlier; constructing the database may take some time depending on the number of libraries).
2626

27-
To add a search path, go to **Solution Explorer**, expand your project node, right-click on **Search Paths**, select **Add Folder to Search Path**:
27+
To add a search path, go to **Solution Explorer**, expand your project node, select and hold (or right-click) on **Search Paths**, and select **Add Folder to Search Path**:
2828

2929
::: moniker range="vs-2017"
3030
![Add Folder to Search Path command on Search Paths in Solution Explorer](media/search-paths-command.png)

0 commit comments

Comments
 (0)