Merge pull request #2785 from madeline-underwood/rabbit_iteration

Rabbit iteration

Author: jasonrandrews

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/_index.md

@@ -1,5 +1,5 @@
 ---
-title: Deploy RabbitMQ on Arm64 Cloud Platforms (Azure & GCP)
+title: Deploy RabbitMQ on Arm64 Cloud Platforms (Azure and GCP)
 
 minutes_to_complete: 30
 

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/azure_baseline.md

@@ -1,17 +1,17 @@
 ---
-title: RabbitMQ Baseline Testing
+title: Validate RabbitMQ on Azure
 weight: 5
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall
 ---
 
-## Run a Baseline Test With RabbitMQ 
-This section validates a working **RabbitMQ 4.2.0** installation with **Erlang OTP 26** on an **Azure Ubuntu Arm64 VM**.  
+## Run a baseline test with RabbitMQ
+This section shows you how to validate a working RabbitMQ 4.2.0 installation with Erlang OTP 26 on an Azure Ubuntu Arm64 VM.  
 
-All steps are **CLI-only** and suitable for baseline verification.
+All steps use the command line and are suitable for baseline verification.
 
-### Verify RabbitMQ Service Status
+## Verify RabbitMQ service status
 
 ```console
 sudo systemctl status rabbitmq

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/azure_installation.md

@@ -1,5 +1,5 @@
 ---
-title: Install RabbitMQ on Microsoft Azure Cobalt 100
+title: Install RabbitMQ on Azure Cobalt 100
 weight: 4
 
 ### FIXED, DO NOT MODIFY
@@ -44,7 +44,7 @@ make clean
 make -j$(nproc)
 sudo make install
 ```
-### Make Erlang PATH persistent (IMPORTANT)
+### Make Erlang PATH persistent 
 This step ensures the Erlang binaries are permanently available in the system PATH across sessions and reboots.
 
 ```console
@@ -53,7 +53,8 @@ echo 'export PATH=$ERLANG_HOME/bin:$PATH' | sudo tee -a /etc/profile.d/erlang.sh
 ```
 
 ### Download and install RabbitMQ
-This section downloads the official RabbitMQ 4.2.0 generic Unix distribution and installs it under `/opt/rabbitmq`.
+
+Download the official RabbitMQ 4.2.0 generic Unix distribution and install it under `/opt/rabbitmq`.
 
 ```console
 cd ~
@@ -66,17 +67,19 @@ sudo mkdir -p /var/lib/rabbitmq /var/log/rabbitmq
 sudo chown -R $USER:$USER /var/lib/rabbitmq /var/log/rabbitmq
 ```
 
-#### Update PATH environment variable
-This step makes RabbitMQ CLI tools available in the current shell and should be persisted for future sessions.
+## Update PATH environment variable
+
+Make RabbitMQ CLI tools available in the current shell. Add this to `~/.bashrc` or `~/.profile` for persistence across sessions.
 
 ```console
 export PATH=/usr/local/erlang-26/bin:/opt/rabbitmq/sbin:$PATH
 ```
 
 Add this line to `~/.bashrc` or `~/.profile` for persistence.
 
-### Configure RabbitMQ systemd service
-This section configures RabbitMQ to run as a managed systemd service, enabling automatic startup and controlled lifecycle management.
+## Configure RabbitMQ systemd service
+
+Configure RabbitMQ to run as a managed systemd service, enabling automatic startup and controlled lifecycle management.
 
 Create `/etc/systemd/system/rabbitmq.service`:
 

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/azure_instance.md

@@ -1,5 +1,5 @@
 ---
-title: Create an Arm based cloud virtual machine using Microsoft Cobalt 100 CPU 
+title: Create an Azure Cobalt 100 virtual machine
 weight: 3
 
 ### FIXED, DO NOT MODIFY
@@ -12,36 +12,38 @@ There are several ways to create an Arm-based Cobalt 100 virtual machine: the Mi
 
 This learning path focuses on the general-purpose virtual machine of the D series. Please read the guide on [Dpsv6 size series](https://learn.microsoft.com/en-us/azure/virtual-machines/sizes/general-purpose/dpsv6-series) offered by Microsoft Azure.  
 
-If you have never used the Microsoft Cloud Platform before, please review the microsoft [guide to Create a Linux virtual machine in the Azure portal](https://learn.microsoft.com/en-us/azure/virtual-machines/linux/quick-create-portal?tabs=ubuntu). 
+## Provision the virtual machine
 
-#### Create an Arm-based Azure Virtual Machine 
+Creating a Cobalt 100 virtual machine follows the same process as creating any other Azure virtual machine. Launch the Azure portal and navigate to **Virtual Machines**.
 
-Creating a virtual machine based on Azure Cobalt 100 is no different from creating any other virtual machine in Azure. To create an Azure virtual machine, launch the Azure portal and navigate to "Virtual Machines".
-1. Select "Create", and click on "Virtual Machine" from the drop-down list.
+Select **Create**, then select **Virtual Machine** from the drop-down list.
 2. Inside the "Basic" tab, fill in the Instance details such as "Virtual machine name" and "Region".
 3. Choose the image for your virtual machine (for example, Ubuntu Pro 24.04 LTS) and select “Arm64” as the VM architecture.
 4. In the “Size” field, click on “See all sizes” and select the D-Series v6 family of virtual machines. Select “D4ps_v6” from the list.
 
 ![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/instance.png "Figure 1: Select the D-Series v6 family of virtual machines")
 
-5. Select "SSH public key" as an Authentication type. Azure will automatically generate an SSH key pair for you and allow you to store it for future use. It is a fast, simple, and secure way to connect to your virtual machine.
-6. Fill in the Administrator username for your VM.
-7. Select "Generate new key pair", and select "RSA SSH Format" as the SSH Key Type. RSA could offer better security with keys longer than 3072 bits. Give a Key pair name to your SSH key.
-8. In the "Inbound port rules", select HTTP (80) and SSH (22) as the inbound ports.
+Select **SSH public key** as the authentication type. Azure automatically generates an SSH key pair and stores it for future use, providing a fast and secure way to connect to your virtual machine.
+
+Fill in the administrator username for your VM.
+
+Select **Generate new key pair**, then select **RSA SSH Format** as the SSH Key Type. RSA offers better security with keys longer than 3072 bits. Provide a name for your SSH key pair.
+
+In the **Inbound port rules** section, select HTTP (80) and SSH (22) as the inbound ports.
 
 ![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/instance1.png "Figure 2: Allow inbound port rules")
 
-9. Click on the "Review + Create" tab and review the configuration for your virtual machine. It should look like the following:
+Select the **Review + Create** tab and review the configuration for your virtual machine. The configuration is similar to:
 
 ![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/ubuntu-pro.png "Figure 3: Review and Create an Azure Cobalt 100 Arm64 VM")
 
-10. Finally, when you are confident about your selection, click on the "Create" button, and click on the "Download Private Key and Create Resources" button.
+When you're satisfied with your configuration, select the Create button, then select Download Private Key and Create Resources.
 
-![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/instance4.png "Figure 4: Download Private key and Create Resources")
+![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/instance4.png "Download Private key and Create Resources")
 
-11. Your virtual machine should be ready and running within no time. You can SSH into the virtual machine using the private key, along with the Public IP details.
+Your virtual machine deploys within a few minutes. SSH into the virtual machine using the downloaded private key and the public IP address.
 
-![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/final-vm.png "Figure 5: VM deployment confirmation in Azure portal")
+![Azure portal VM creation — Azure Cobalt 100 Arm64 virtual machine (D4ps_v6) alt-text#center](images/final-vm.png "VM deployment confirmation in Azure portal")
 
 {{% notice Note %}}
 

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/background.md

@@ -1,28 +1,28 @@
 ---
-title: Technology Stack Overview
+title: Learn about Arm-based cloud platforms for RabbitMQ
 
 weight: 2
 
 layout: "learningpathall"
 ---
 
-## Cobalt 100 Arm-based processor
+## Understand Azure Cobalt 100 processors
 
-Azure’s Cobalt 100 is built on Microsoft's first-generation, in-house Arm-based processor: the Cobalt 100. Designed entirely by Microsoft and based on Arm’s Neoverse N2 architecture, this 64-bit CPU delivers improved performance and energy efficiency across a broad spectrum of cloud-native, scale-out Linux workloads. These include web and application servers, data analytics, open-source databases, caching systems, and other related technologies. Running at 3.4 GHz, the Cobalt 100 processor allocates a dedicated physical core for each vCPU, ensuring consistent and predictable performance. 
+Azure's Cobalt 100 is Microsoft's first-generation, in-house Arm-based processor. Designed entirely by Microsoft and based on Arm's Neoverse N2 architecture, this 64-bit CPU delivers improved performance and energy efficiency across a broad spectrum of cloud-native, scale-out Linux workloads. These include web and application servers, data analytics, open-source databases, caching systems, and other related technologies. Running at 3.4 GHz, the Cobalt 100 processor allocates a dedicated physical core for each vCPU, ensuring consistent and predictable performance.
 
-To learn more about Cobalt 100, refer to the blog [Announcing the preview of new Azure virtual machine based on the Azure Cobalt 100 processor](https://techcommunity.microsoft.com/blog/azurecompute/announcing-the-preview-of-new-azure-vms-based-on-the-azure-cobalt-100-processor/4146353).
+For more information about Cobalt 100, see the blog [Announcing the preview of new Azure virtual machine based on the Azure Cobalt 100 processor](https://techcommunity.microsoft.com/blog/azurecompute/announcing-the-preview-of-new-vms-based-on-the-azure-cobalt-100-processor/4146353).
 
-## Google Axion C4A Arm instances in Google Cloud
+## Understand Google Axion C4A instances
 
-Google Axion C4A is a family of Arm-based virtual machines built on Google’s custom Axion CPU, which is based on Arm Neoverse-V2 cores. Designed for high-performance and energy-efficient computing, these virtual machines offer strong performance for modern cloud workloads such as CI/CD pipelines, microservices, media processing, and general-purpose applications.
+Google Axion C4A is a family of Arm-based virtual machines built on Google's custom Axion CPU, based on Arm Neoverse V2 cores. These virtual machines offer high-performance and energy-efficient computing for modern cloud workloads such as CI/CD pipelines, microservices, media processing, and general-purpose applications.
 
 The C4A series provides a cost-effective alternative to x86 virtual machines while leveraging the scalability and performance benefits of the Arm architecture in Google Cloud.
 
-To learn more about Google Axion, see the [Introducing Google Axion Processors, Arm-based CPUs](https://cloud.google.com/blog/products/compute/introducing-googles-new-arm-based-cpu) blog.
+For more information about Google Axion, see the [Introducing Google Axion Processors, Arm-based CPUs](https://cloud.google.com/blog/products/compute/introducing-googles-new-arm-based-cpu) blog.
 
-## RabbitMQ
+## Understand RabbitMQ messaging
 
-RabbitMQ is an open-source **message broker** that enables applications to communicate asynchronously using messaging patterns such as queues, publish/subscribe, and routing. It acts as an intermediary that reliably receives, stores, and forwards messages between producers and consumers.
+RabbitMQ is an open-source message broker that enables applications to communicate asynchronously using messaging patterns such as queues, publish/subscribe, and routing. It acts as an intermediary that reliably receives, stores, and forwards messages between producers and consumers.
 
 RabbitMQ helps decouple application components, improve scalability, and increase fault tolerance by ensuring messages are not lost and can be processed independently. It supports multiple messaging protocols, including AMQP, and provides features such as message durability, acknowledgments, routing via exchanges, and flexible delivery guarantees.
 

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/gcp_baseline.md

@@ -1,21 +1,20 @@
 ---
-title: RabbitMQ Baseline Testing on Google Axion C4A Arm Virtual Machine
+title: Validate RabbitMQ on Google Cloud
 weight: 9
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall
 ---
 
-## RabbitMQ Baseline Validation on GCP SUSE Arm64 VM
-This document defines a **baseline validation procedure** for RabbitMQ installed on a **Google Cloud SUSE Linux Arm64 virtual machine**.  
-The purpose of this baseline is to confirm:
+Validate your RabbitMQ installation on the Google Cloud SUSE Linux Arm64 virtual machine. This baseline confirms:
 
 - RabbitMQ service health
 - Management plugin availability
 - Queue operations (create, publish, consume)
 - CLI tooling functionality (`rabbitmqctl` and `rabbitmqadmin`)
 
-### Check RabbitMQ node status
+## Check RabbitMQ node status
+
 Verify that the RabbitMQ node is operational and healthy.
 
 ```console

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/gcp_firewall_setup.md

@@ -1,22 +1,18 @@
 ---
-title: Create a Firewall Rule on GCP
+title: Create a firewall rule for RabbitMQ
 weight: 6
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall
 ---
 
-## Overview
-
-In this section, you create a Firewall Rule within Google Cloud Console to expose TCP port 15672.
+Create a firewall rule in Google Cloud Console to expose TCP port 15672 for the RabbitMQ management interface.
 
 {{% notice Note %}}
 For support on GCP setup, see the Learning Path [Getting started with Google Cloud Platform](/learning-paths/servers-and-cloud-computing/csp/google/).
 {{% /notice %}}
 
-## Create a Firewall Rule in GCP
-
-To expose TCP port 15672, create a firewall rule.
+## Configure the firewall rule
 
 Navigate to the [Google Cloud Console](https://console.cloud.google.com/), go to **VPC Network > Firewall**, and select **Create firewall rule**.
 

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/gcp_installation.md

@@ -1,38 +1,40 @@
 ---
-title: Install RabbitMQ on GCP SUSE Arm64 VM
+title: Install RabbitMQ on Google Cloud SUSE VM
 weight: 8
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall
 ---
 
-## Install RabbitMQ on GCP SUSE Arm64 VM
-This guide describes a **step-by-step installation of RabbitMQ** on a **Google Cloud Platform SUSE Linux Arm64 virtual machine**, using **RPM packages** for both **Erlang** and **RabbitMQ Server**.
+Install RabbitMQ on a Google Cloud Platform SUSE Linux Arm64 virtual machine using RPM packages for both Erlang and RabbitMQ Server.
 
-RabbitMQ needs Erlang to be installed before setting up the server.
+RabbitMQ requires Erlang to be installed first.
 
 
-### Prerequisites
+You need:
 
 - GCP SUSE Linux Enterprise Server (Arm64)
 - Root or sudo privileges
 - Outbound internet access
 
-### Refresh system repositories
-This step updates the system’s package list so the operating system knows about the latest software available from its repositories.
+## Refresh system repositories
+
+Update the system's package list so the operating system recognizes the latest software available from its repositories.
 
 ```console
 sudo zypper refresh
 ```
 
-### Install required system utilities
-You can install the basic tools needed to download and manage packages.
+## Install required system utilities
+
+Install the basic tools needed to download and manage packages.
 
 ```console
 sudo zypper install -y curl wget gnupg tar socat logrotate
 ```
 
-### Download Erlang RPM (Arm64)
+## Download Erlang RPM (Arm64)
+
 RabbitMQ depends on Erlang. Download the Erlang RPM compatible with the Arm64 architecture.
 
 ```console

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/gcp_instance.md

@@ -1,5 +1,5 @@
 ---
-title: Create a Google Axion C4A Arm virtual machine on GCP 
+title: Create a Google Axion C4A virtual machine
 weight: 7
 
 ### FIXED, DO NOT MODIFY
@@ -8,8 +8,7 @@ layout: learningpathall
 
 ## Overview
 
-In this section, you provision a Google Axion C4A Arm virtual machine on Google Cloud Platform (GCP) using the `c4a-standard-4` (4 vCPUs, 16 GB memory) machine type in the Google Cloud Console.  
-We will then use this GCP VM to execute a few RabbitMQ use cases.
+In this section, you'll provision a Google Axion C4A Arm virtual machine on Google Cloud Platform (GCP) using the `c4a-standard-4` (4 vCPUs, 16 GB memory) machine type in the Google Cloud Console. You will then use this GCP VM to execute a few RabbitMQ use cases.
 
 {{% notice Note %}}
 For support on GCP setup, see the Learning Path [Getting started with Google Cloud Platform](/learning-paths/servers-and-cloud-computing/csp/google/).
@@ -23,18 +22,16 @@ Under **Machine configuration**, populate fields such as **Instance name**, **Re
 
    ![Create a Google Axion C4A Arm virtual machine in the Google Cloud Console with c4a-standard-4 selected alt-text#center](images/gcp-vm.png "Creating a Google Axion C4A Arm virtual machine in Google Cloud Console")
 
-Under **OS and Storage**, select **Change**, then choose an Arm64-based OS image. For this Learning Path, use **SUSE Linux Enterprise Server**. Select "Pay As You Go" for the license type and press **Select**.
+Under **OS and Storage**, select **Change**, then choose an Arm64-based OS image. For this Learning Path, use **SUSE Linux Enterprise Server**. Select **Pay As You Go** for the license type and select **Select**.
 
 Under **Networking**, enable **Allow HTTP traffic** and add "allow-tcp-15672" as a network tag in the **Network tags** text field.
 
-![Adding the TCP/15672 firewall rule to the VM](images/network-config.png "Adding the TCP/15672 firewall rule to the VM")
+![Adding the TCP/15672 firewall rule to the VM alt-text#center](images/network-config.png "Adding the TCP/15672 firewall rule to the VM")
 
-Select **Create** to launch the instance. Once created, you see an **SSH** option and the public IP address for your VM in the list of VM instances. Save the public IP address as you need it in the next step. Select the **SSH** option to launch an SSH shell into your VM instance.
+Select **Create** to launch the instance. After the instance is created, the **SSH** option and public IP address appear in the VM instances list. Save the public IP address for later use. Select the **SSH** option to open an SSH shell to your VM instance.
 
 ![Invoke an SSH session via your browser alt-text#center](images/gcp-pubip-ssh.png "Invoke an SSH session into your running VM instance")
 
-A window opens from your browser and you see a shell into your VM instance.
+A browser window opens with a shell session to your VM instance.
 
 ![Terminal Shell in your VM instance alt-text#center](images/gcp-shell.png "Terminal shell in your VM instance")
-
-Next, install RabbitMQ.

content/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/gcp_use_case1.md

@@ -1,5 +1,5 @@
 ---
-title: RabbitMQ Use Case 1 – Event Processing with Python Workers
+title: RabbitMQ use Case 1 - event processing with Python Workers
 weight: 10
 
 ### FIXED, DO NOT MODIFY