differences for PR #3

Author: actions-user

12-running-vscode.md

@@ -58,7 +58,7 @@ There are many other features and ways to access them, and we'll cover key ones
 
 Extensions are a major strength of VSCode. Whilst VSCode appears quite lightweight, and presents a simple interface (particularly compared to many other IDEs!), this is quite deceptive.
 You can extend its functionality in many different ways. 
-or example, installing support for other languages, greater support for version control, there's even support for working with databases, and so on.
+For example, installing support for other languages, greater support for version control, there's even support for working with databases, and so on.
 There are literally tens of thousands of possible extensions now.
 
 Now VSCode already comes with built-in support for JavaScript, including TypeScript and node.js,
@@ -67,24 +67,24 @@ Installing a language extension will allow you to do more things with that parti
 
 Let's install an extension now:
 
-1. Firstly, select the extensions icon first, then type in Python into the search box at the top, and it'll give you a list of all python-related extensions.
+1. Firstly, select the extensions icon, then type in "Python" into the search box at the top, and it'll give you a list of all Python-related extensions.
 1. Select the one which says `Python` from Microsoft. This is the Microsoft official Python extension.
 1. Then select `Install`.
 
 It might take a minute - you can see a sliding blue line in the top left to indicate it's working.
 Once complete, you should see a couple of "Welcome" windows introducing you to two of its key features - support for Python and Jupyter notebooks.
 If you use Jupyter notebooks, which is a way of writing Python programs that you can run line by line from within an editor as you write the program, you may find this useful.
 
-For now, let's configure this extension for our Python development, and to do that, we need to do is tell VSCode which Python installation on our machine we'd like it to use. In the Python Welcome window, select `Select a Python interpreter`, and then `Select Python interpreter`.
-You may find you have many installations of Python, or only have one. Try to select one later than 3.8 if you can.
-Then select `Mark done`, and close the welcome windows.
+For now, let's configure this extension for our Python development, and to do that, we need to tell VSCode which Python installation on our machine we'd like it to use. In the Python Welcome window, select `Select a Python interpreter`, and then `Select Python interpreter`.
+You may find you have many installations of Python, or only have one. Try to select the version later than 3.8 if you can.
+Then select `Mark done`, and close the Welcome window.
 
 ## A Sample Project
 
 FIXME: copy code-style-example repo to softwaresaved's organisation
 
 Next, let's obtain some example Python and edit it from within VSCode.
-So first, you can download the example code we'll use from https://github.com/UNIVERSE-HPC/code-style-example/releases/tag/v1.0.0, either as a `.zip` or `.tar.gz` compressed archive file.
+First, download the example code we'll use from https://github.com/UNIVERSE-HPC/code-style-example/releases/tag/v1.0.0, either as a `.zip` or `.tar.gz` compressed archive file.
 If you're unsure, download the `.zip` file.
 Then, extract all the files from the archive into a convenient location.
 You should see files contained within a new directory named `code-style-example-1.0.0`.
@@ -103,9 +103,9 @@ Note that we're looking for the *folder* that contains the files, not a specific
 
 If your system has the Git version control system installed, you may see a `Clone Repository` option here too.
 If you are familiar with Git and wish to use this option instead,
-select this option instead and enter the repository's location as `https://github.com/UNIVERSE-HPC/code-style-example`.
+select it and enter the repository's location as `https://github.com/UNIVERSE-HPC/code-style-example`.
 Then use the file browser that is presented to find a convenient location to store the cloned code and click on `Select as Repository Destination`,
-then select `Open` when ‘Would you like to open the cloned repository?' appears.
+then select `Open` when ‘Would you like to open the cloned repository?' popup appears.
 
 :::::::::::::::::::::::::::::::::::::::::
 
@@ -126,7 +126,7 @@ So next, let's look at editing code.
 
 ::::::::::::::::::::::::::::::::::::: keypoints 
 
-- Key VSCode features are accessible via the left navigation bar and the menu.
+- Key VSCode features are accessible via the left navigation bar and the menu
 - VSCode's capabilities can be increased by installing extensions
 - Language-specific support is available via extensions
 - A VSCode "workspace" is a project that consists of a collection of folder and files

13-code-editor.md

@@ -41,7 +41,7 @@ But in essence, the code is designed to do the following:
 1. Open a file in the CSV (comma separated value) format
 1. Go through the file line by line, and:
    - If the line begins with a `#` symbol, ignore it.
-   - Otherwise, extract the fourth column (which is in Fahrenheit), convert it to Celsius and Kelvin, and output those readings.
+   - Otherwise, extract the fourth column (which contains temperature in Fahrenheit), convert it to Celsius and Kelvin, and output those readings.
 
 Let's take a look at some of what the code editor gives us.
 

fig/.gitkeep

@@ -6,8 +6,8 @@
 "links.md" "3191a9ad7a8ab470710936b6f372a0b5" "site/built/links.md" "2025-04-17"
 "episodes/10-introduction.md" "d4f56612792b2a6e597b090b963b8671" "site/built/10-introduction.md" "2025-05-01"
 "episodes/11-setup.md" "f58103cf58d052e2519abda5624f76d6" "site/built/11-setup.md" "2025-04-30"
-"episodes/12-running-vscode.md" "76540d245e3ae8ad97b05bf239ec9676" "site/built/12-running-vscode.md" "2025-05-08"
-"episodes/13-code-editor.md" "88fa96ec8f4ead06f55c62018764c9ba" "site/built/13-code-editor.md" "2025-05-09"
+"episodes/12-running-vscode.md" "77f1013e07165584de1a3fdb7f1b7d33" "site/built/12-running-vscode.md" "2025-05-09"
+"episodes/13-code-editor.md" "34760d539f13c0e30cb86a4fb1679462" "site/built/13-code-editor.md" "2025-05-09"
 "episodes/14-running-debugging.md" "f371f042deec6d37bdebb143ab851488" "site/built/14-running-debugging.md" "2025-05-09"
 "episodes/20-introduction.md" "ab522284cfcceb13671dfb1ca5670c97" "site/built/20-introduction.md" "2025-05-01"
 "episodes/21-setup.md" "eb31e0147eb4306d480fff570786023f" "site/built/21-setup.md" "2025-04-30"