Merge pull request #3146 from madeline-underwood/post

refactor: update titles and content for PostgreSQL learning path sect…

Author: pareenaverma

content/learning-paths/servers-and-cloud-computing/postgresql-cobalt/_index.md

@@ -1,10 +1,6 @@
 ---
 title: Deploy PostgreSQL on Azure Cobalt 100 Arm64 virtual machines
 
-draft: true
-cascade:
-    draft: true
-    
 minutes_to_complete: 30
 
 who_is_this_for: This learning path is designed for developers, DevOps engineers, and platform engineers who want to deploy, manage, and optimize PostgreSQL databases on Arm-based cloud infrastructure.

content/learning-paths/servers-and-cloud-computing/postgresql-cobalt/background.md

@@ -1,11 +1,15 @@
 ---
-title: "Overview of Azure Cobalt 100 and PostgreSQL"
+title: Understand PostgreSQL on Azure Cobalt 100
 
 weight: 2
 
 layout: "learningpathall"
 ---
 
+## Why run PostgreSQL on Azure Cobalt 100
+
+PostgreSQL on Arm-based Azure Cobalt 100 processors delivers efficient database performance for both transactional and analytical workloads. Cobalt 100's dedicated physical cores per vCPU provide consistent performance that suits PostgreSQL's multi-process architecture and parallel query execution.
+
 ## Azure Cobalt 100 Arm-based processor
 
 Azure’s Cobalt 100 is Microsoft’s first-generation, in-house Arm-based processor. Built on Arm Neoverse N2, Cobalt 100 is a 64-bit CPU that delivers strong performance and energy efficiency for cloud-native, scale-out Linux workloads such as web and application servers, data analytics, open-source databases, and caching systems. Running at 3.4 GHz, Cobalt 100 allocates a dedicated physical core for each vCPU, which helps ensure consistent and predictable performance.

content/learning-paths/servers-and-cloud-computing/postgresql-cobalt/benchmark-and-tuning.md

@@ -1,12 +1,12 @@
 ---
-title: Benchmark and Tune PostgreSQL
+title: Benchmark and optimize PostgreSQL on Cobalt 100
 weight: 6
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall
 ---
 
-# Benchmark and Tune PostgreSQL
+## Measure and improve database performance
 
 In this section, you benchmark PostgreSQL performance and optimize query execution using monitoring and indexing techniques.
 
@@ -24,7 +24,8 @@ Use `pgbench` to prepare a benchmarking dataset.
 ```console
 sudo -u postgres pgbench -i -s 50 appdb
 ```
-This creates standard benchmarking tables and loads data for testing. The output looks similar to:
+
+The command creates standard benchmarking tables and loads data for testing. The output looks similar to:
 
 ```output
 dropping old tables...
@@ -73,7 +74,7 @@ initial connection time = 10.771 ms
 tps = 2401.873115 (without initial connection time)
 ```
 
-This result shows the transactional (OLTP) throughput PostgreSQL achieves on this Cobalt 100 Arm64 instance under the configured load. TPS and latency will vary with instance size, client count, and workload shape.
+The result shows the transactional (OLTP) throughput PostgreSQL achieves on this Cobalt 100 Arm64 instance under the configured load. TPS and latency will vary with instance size, client count, and workload shape.
 
 ## Enable query monitoring
 
@@ -125,7 +126,7 @@ The output is similar to:
 (1 row)
 ```
 
-This helps identify performance bottlenecks.
+The output helps identify performance bottlenecks.
 
 ## Analyze query execution
 
@@ -193,6 +194,8 @@ Foreign-key constraints:
 
 The index `idx_orders_customer_id` is now listed alongside the primary key index. PostgreSQL's query planner will use it for queries that filter or join on `customer_id`, reducing full table scans for those operations.
 
+## Summary
+
 You've successfully benchmarked and optimized PostgreSQL on an Arm64 system. Your setup now includes:
 
 - Transactional benchmarking using pgbench

content/learning-paths/servers-and-cloud-computing/postgresql-cobalt/deploy-and-query.md

@@ -1,12 +1,12 @@
 ---
-title: Deploy Schema and Run Queries
+title: Deploy a relational schema and run queries
 weight: 5
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall
 ---
 
-# Deploy Schema and Run Queries
+## Create transactional data for PostgreSQL
 
 In this section, you create database tables, load sample data, and execute analytical queries on PostgreSQL.
 
@@ -116,7 +116,7 @@ The output is similar to:
 
 ## Top customers by spending
 
-This query aggregates order totals per customer across the full orders table — a typical OLAP aggregation on OLTP data.
+The following query aggregates order totals per customer across the full orders table — a typical OLAP aggregation on OLTP data.
 
 ```sql
 SELECT customer_id, SUM(amount) AS total_spent
@@ -154,7 +154,7 @@ The output is similar to:
 
 ## Customer order counts
 
-This query joins customers and orders, counts how many orders each customer placed, and ranks them by activity. It's a multi-table analytical query — the join across two OLTP tables produces an OLAP-style activity report.
+The following query joins customers and orders, counts how many orders each customer placed, and ranks them by activity. It's a multi-table analytical query — the join across two OLTP tables produces an OLAP-style activity report.
 
 ```sql
 SELECT c.name, COUNT(o.id)
@@ -206,7 +206,7 @@ psql -h localhost -U appuser -d appdb
 
 When prompted for a password, enter `StrongPassword123`.
 
-## What you've accomplished and what's next
+## What you've learned and what's next
 
 You've successfully deployed a relational schema and executed analytical queries on PostgreSQL. Your setup includes:
 

content/learning-paths/servers-and-cloud-computing/postgresql-cobalt/instance.md

@@ -6,6 +6,10 @@ weight: 3
 layout: learningpathall
 ---
 
+## Provision Azure infrastructure for PostgreSQL
+
+Create an Arm-based Cobalt 100 virtual machine to host your PostgreSQL database.
+
 ## Prerequisites and setup
 
 There are several common ways to create an Arm-based Cobalt 100 virtual machine, and you can choose the method that best fits your workflow or requirements:
@@ -16,7 +20,7 @@ There are several common ways to create an Arm-based Cobalt 100 virtual machine,
 
 In this section, you will launch the Azure Portal to create a virtual machine with the Arm-based Azure Cobalt 100 processor.
 
-This Learning Path focuses on general-purpose virtual machines in the Dpsv6 series. For more information, see the [Microsoft Azure guide for the Dpsv6 size series](https://learn.microsoft.com/en-us/azure/virtual-machines/sizes/general-purpose/dpsv6-series).
+The Learning Path focuses on general-purpose virtual machines in the Dpsv6 series. For more information, see the [Microsoft Azure guide for the Dpsv6 size series](https://learn.microsoft.com/en-us/azure/virtual-machines/sizes/general-purpose/dpsv6-series).
 
 While the steps to create this instance are included here for convenience, you can also refer to the [Deploy a Cobalt 100 virtual machine on Azure Learning Path](/learning-paths/servers-and-cloud-computing/cobalt/).
 
@@ -65,7 +69,7 @@ Your virtual machine should be ready and running in a few minutes. You can SSH i
 
 {{% notice Note %}}To learn more about Arm-based virtual machines in Azure, see "Getting Started with Microsoft Azure" in [Get started with Arm-based cloud instances](/learning-paths/servers-and-cloud-computing/csp/azure/).{{% /notice %}}
 
-## What you've accomplished and what's next
+## What you've learned and what's next
 
 You've successfully:
 

content/learning-paths/servers-and-cloud-computing/postgresql-cobalt/setup-and-install.md

@@ -1,12 +1,12 @@
 ---
-title: Setup and Install PostgreSQL on Cobalt 100
+title: Install and configure PostgreSQL on Cobalt 100
 weight: 4
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall
 ---
 
-# Setup and Install PostgreSQL on Cobalt 100 (Arm64)
+## Prepare PostgreSQL for Arm deployment
 
 In this section, you install and configure PostgreSQL on an Azure Ubuntu 24.04 Pro Arm64 virtual machine running on Cobalt 100 processors.
 
@@ -154,7 +154,7 @@ max_parallel_workers_per_gather = 4
 sudo systemctl restart postgresql
 ```
 
-## What you've accomplished and what's next
+## What you've learned and what's next
 
 You've successfully installed and configured PostgreSQL on an Azure Ubuntu Arm64 virtual machine. Your setup includes: