Refactor section headings and improve clarity in Golang installation and baseline testing documentation

Author: madeline-underwood

content/learning-paths/servers-and-cloud-computing/golang-on-azure/baseline-testing.md

@@ -6,22 +6,20 @@ weight: 5
 layout: learningpathall
 ---
 
+## Baseline testing: run a Go web server on Azure Arm64
 
-### Baseline Testing: Running a Go Web Server on Azure Arm64
-To validate your Go toolchain and runtime environment, you can build and run a lightweight web server. This ensures that compilation, networking, and runtime execution are working correctly on your Ubuntu Pro 24.04 LTS Arm64 virtual machine running on Azure Cobalt 100.
+To validate your Go toolchain and runtime environment, build and run a lightweight web server. This confirms that compilation, networking, and runtime execution work correctly on your Ubuntu Pro 24.04 LTS Arm64 virtual machine on Azure Cobalt 100.
 
-1. Create the project directory
-   
-Start by creating a new folder to hold your Go web project and navigate to it:
+## Create the project directory
 
+Create a folder for your Go web project and navigate to it:
 ```console
 mkdir goweb && cd goweb
 ```
 
-2. Create an HTML Page with Bootstrap Styling
-
-Next, create a simple web page that your Go server will serve. Using the nano editor (or any editor of your choice), create a file named `index.html`:
+## Create an HTML page with Bootstrap styling
 
+Next, create a simple web page that your Go server will serve. Open an editor and create `index.html`:
 ```console
 nano index.html
 ```
@@ -65,15 +63,16 @@ Paste the following HTML code into the `index.html` file. This page uses Bootstr
 </body>
 </html>
 ```
-3. Create Golang Web Server
 
 Now, let’s create the Go program that will serve your static HTML page and expose a simple API endpoint.
 
+Open an editor and create `main.go`:
 ```console
 nano main.go
 ```
-Paste the following code into the `main.go` file. This sets up a very basic web server that serves files from the current folder, including the `index.html` you just created. When it runs, it will print a message showing the server address.
+Paste the following code into the `main.go` file. This sets up a basic web server that serves files from the current folder, including the `index.html` you just created. When it runs, it will print a message showing the server address.
 
+Paste the following code into `main.go`:
 ```go
 package main
 import (
@@ -105,24 +104,21 @@ func main() {
 ```
 {{% notice Note %}}Running on port 80 requires root privileges. Use sudo with the full Go path if needed.{{% /notice %}}
 
-4. Run the Web Server
-   
-Compile and start your Go program with:
+## Run the web server
 
+Compile and start the server:
 ```console
 sudo /usr/local/go/bin/go run main.go
 ```
 
-This command compiles the Go source code into a binary and immediately starts the server on port 80. If the server starts successfully, you will see the following message in your terminal:
-
+Expected output:
 ```output
 2025/08/19 04:35:06 Server running on http://0.0.0.0:80
 ```
-5. Allow HTTP Traffic in Firewall
 
 On Ubuntu Pro 24.04 LTS virtual machines, UFW (Uncomplicated Firewall) is used to manage firewall rules. By default, it allows only SSH (port 22), while other inbound connections are blocked. 
 
-Even if you have already configured Azure Network Security Group (NSG) rules to allow inbound traffic on port 80, the VM level firewall may still block HTTP requests until explicitly opened.
+Even if you have already configured Azure Network Security Group (NSG) rules to allow inbound traffic on port 80, the VM level firewall might still block HTTP requests until explicitly opened.
 
 Run the following commands to allow HTTP traffic on port 80:
 
@@ -145,14 +141,19 @@ To                         Action      From
 80/tcp (v6)                ALLOW       Anywhere (v6)
 ```
 
-6. Open in a Browser
-To quickly get your VM’s public IP address and form the URL, run:
+{{% notice Note %}}
+If UFW is already active, `sudo ufw enable` might warn you about disrupting SSH. Proceed only if you understand the impact, or use an Azure VM serial console as a recovery option.
+{{% /notice %}}
 
+## Open the site in a browser
+
+Print your VM’s public URL:
 ```console
 echo "http://$(curl -s ifconfig.me)/"
 ```
-Open this URL in your browser, and you should see the styled HTML landing page being served directly by your Go application.
 
-![golang](images/go-web.png)
+Open this URL in your browser. You should see the styled HTML landing page served by your Go application.
+
+![Go web server running on Azure Arm64 alt-text#center](images/go-web.png "Go web server running on Azure Arm64")
 
-Reaching this page in your browser confirms that Go is installed correctly, your environment is configured, and your Go web server is working end-to-end on Azure Cobalt 100 (Arm64). You can now proceed to perform further benchmarking tests.                                                      
+Reaching this page confirms that Go is installed, the environment is configured, and your Go web server works end-to-end on Azure Cobalt 100 (Arm64). You can now proceed to benchmarking tests.

content/learning-paths/servers-and-cloud-computing/golang-on-azure/deploy.md

@@ -23,23 +23,23 @@ There are many enhancements added to Golang version 1.18, that have resulted in
 The [Arm Ecosystem Dashboard](https://developer.arm.com/ecosystem-dashboard/) also recommends Golang version 1.18 as the minimum recommended on the Arm platforms.
 {{% /notice %}}
 
-## Extract the archive to `/usr/local`
+## Extract the archive 
 
 Unpack the downloaded archive into `/usr/local`, which is the conventional directory for installing system-wide software on Linux. This ensures the Go toolchain is available for all users and integrates cleanly with the system’s environment.
 
 ```console
 sudo tar -C /usr/local -xzf ./go1.25.0.linux-arm64.tar.gz
 ```
 
-## Add Go to your shell `PATH`
+## Add Go to your shell PATH
 
 To make the Go toolchain accessible from any directory, add its binary location to your shell’s `PATH` environment variable. Updating your `.bashrc` file ensures this change persists across sessions:
 
 ```console
 echo 'export PATH="$PATH:/usr/local/go/bin"' >> ~/.bashrc
 ```
 
-## Apply the changes immediately
+## Apply the changes
 
 After updating .bashrc, reload it so your current shell session picks up the new environment variables without requiring you to log out and back in: