Enhance documentation for Golang baseline testing and deployment on Azure Cobalt 100. Update titles, add descriptions, and improve clarity in installation and configuration instructions.

madeline-underwood · madeline-underwood · commit 51b4722e1197 · 2025-09-30T13:56:29.000+01:00
diff --git a/content/learning-paths/servers-and-cloud-computing/golang-on-azure/baseline-testing.md b/content/learning-paths/servers-and-cloud-computing/golang-on-azure/baseline-testing.md
@@ -1,5 +1,5 @@
 ---
-title: Golang baseline testing 
+title: Golang baseline testing and web server deployment on Azure Cobalt 100 
 weight: 5
 
 ### FIXED, DO NOT MODIFY
@@ -8,11 +8,12 @@ layout: learningpathall
 
 ## Baseline testing: run a Go web server on Azure Arm64
 
-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.
+Validate your Go development environment by building and deploying a complete web application. This baseline test confirms that compilation, networking, and runtime execution work correctly on your Ubuntu Pro 24.04 LTS Arm64 virtual machine powered by Azure Cobalt 100 processors.
 
-## Create the project directory
+## Initialize Go Web Project
+
+Create a dedicated project directory for your Go web application:
 
-Create a folder for your Go web project and navigate to it:
 ```console
 mkdir goweb && cd goweb
 ```
@@ -24,7 +25,7 @@ Next, create a simple web page that your Go server will serve. Open an editor an
 nano index.html
 ```
 
-Paste the following HTML code into the `index.html` file. This page uses Bootstrap for styling and includes a header, a welcome message, and a button that links to a Go-powered API endpoint.
+Add the following HTML code with Bootstrap styling and Azure Cobalt 100 branding:
 
 ```html
 <!DOCTYPE html>
@@ -104,21 +105,22 @@ func main() {
 ```
 {{% notice Note %}}Running on port 80 requires root privileges. Use sudo with the full Go path if needed.{{% /notice %}}
 
-## Run the web server
+## Deploy and Start the Web Server
+
+Compile and launch your Go web server on Azure Cobalt 100:
 
-Compile and start the server:
 ```console
 sudo /usr/local/go/bin/go run main.go
 ```
 
-Expected output:
+Expected output confirming successful startup:
 ```output
 2025/08/19 04:35:06 Server running on http://0.0.0.0:80
 ```
 
-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. 
+### Configure Ubuntu Firewall for HTTP Access
 
-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.
+Ubuntu Pro 24.04 LTS uses UFW (Uncomplicated Firewall) to manage network access. Even with Azure Network Security Group (NSG) rules configured, the VM-level firewall requires explicit HTTP access configuration.
 
 Run the following commands to allow HTTP traffic on port 80:
 
@@ -154,6 +156,14 @@ echo "http://$(curl -s ifconfig.me)/"
 
 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")
+![Go web server running on Azure Cobalt 100 Arm64 alt-text#center](images/go-web.png "Go web server running on Azure Cobalt 100 Arm64")
+
+## Baseline Testing Complete
+
+Successfully reaching this page confirms:
+- **Go toolchain** is properly installed and configured
+- **Development environment** is ready for Arm64 compilation
+- **Network connectivity** and firewall configuration are correct
+- **Runtime performance** is functioning on Azure Cobalt 100 processors
 
-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.
+Your Azure Cobalt 100 virtual machine is now ready for advanced Go application development and performance benchmarking.
diff --git a/content/learning-paths/servers-and-cloud-computing/golang-on-azure/deploy.md b/content/learning-paths/servers-and-cloud-computing/golang-on-azure/deploy.md
@@ -6,13 +6,14 @@ weight: 4
 layout: learningpathall
 ---
 
-## Install Golang on Ubuntu Pro 24.04 LTS (Arm64)
+## Install Golang on Azure Cobalt 100 (Ubuntu Pro 24.04 LTS Arm64)
 
-This section shows how to install the Go toolchain on Ubuntu Pro 24.04 LTS (Arm64), configure your environment, and verify the setup for benchmarking on Azure Cobalt 100 VMs.
+This section demonstrates how to install the Go programming language toolchain on Ubuntu Pro 24.04 LTS (Arm64), configure your development environment, and verify the setup for optimal performance on Azure Cobalt 100 virtual machines.
 
-## Download the Go archive
+## Download the Official Go Distribution
+
+Download the latest Arm64-optimized Go distribution directly from the official Go website. This ensures you get the best performance on Azure Cobalt 100 processors:
 
-Use the following command to download the Arm64 build from the official Go distribution (update the version as needed):
 ```console
 wget https://go.dev/dl/go1.25.0.linux-arm64.tar.gz
 ```
@@ -39,9 +40,9 @@ To make the Go toolchain accessible from any directory, add its binary location
 echo 'export PATH="$PATH:/usr/local/go/bin"' >> ~/.bashrc
 ```
 
-## Apply the changes
+## Reload Shell Configuration
 
-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:
+Apply the environment changes to your current shell session without requiring a logout/login cycle:
 
 ```console
 source ~/.bashrc
