Refactor documentation: update titles and section headings for clarity and consistency across TypeScript guides

Author: madeline-underwood

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

@@ -1,9 +1,5 @@
 ---
 title: Deploy TypeScript on Google Cloud C4A (Arm-based Axion VMs)
-
-draft: true
-cascade:
-    draft: true
 
 minutes_to_complete: 30
 

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

@@ -1,5 +1,5 @@
 ---
-title: Getting started with TypeScript on Google Axion C4A (Arm Neoverse-V2)
+title: Getting started with TypeScript
 
 weight: 2
 
@@ -12,12 +12,12 @@ Google Axion C4A is a family of Arm-based virtual machines built on Google’s c
 
 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, refer to the [Introducing Google Axion Processors, our new Arm-based CPUs](https://cloud.google.com/blog/products/compute/introducing-googles-new-arm-based-cpu) blog.
+To learn more about Google Axion, see the Google blog [Introducing Google Axion Processors, our new Arm-based CPUs](https://cloud.google.com/blog/products/compute/introducing-googles-new-arm-based-cpu).
 
 ## TypeScript
 
-TypeScript is an open-source, strongly typed programming language developed and maintained by Microsoft.  
+TypeScript is an open-source, strongly-typed programming language developed and maintained by Microsoft.  
 
-It is a superset of JavaScript, which means all valid JavaScript code is also valid TypeScript, but TypeScript adds static typing, interfaces, and advanced tooling to help developers write more reliable and maintainable code.  
+TypeScript builds on JavaScript by adding features like static typing and interfaces. Any valid JavaScript code works in TypeScript, but TypeScript gives you extra tools to write code that is easier to maintain and less prone to errors. 
 
-TypeScript is widely used for web applications, server-side development (Node.js), and large-scale JavaScript projects** where type safety and code quality are important. Learn more from the [TypeScript official website](https://www.typescriptlang.org/) and its [handbook and documentation](https://www.typescriptlang.org/docs/).
+TypeScript is widely used for web applications, server-side development (Node.js), and large-scale JavaScript projects where type safety and code quality are important. Learn more from the [TypeScript official website](https://www.typescriptlang.org/) and the [TypeScript handbook and documentation](https://www.typescriptlang.org/docs/).

content/learning-paths/servers-and-cloud-computing/typescript-on-gcp/baseline.md

@@ -1,19 +1,19 @@
 ---
-title: TypeScript Baseline Testing on Google Axion C4A Arm Virtual Machine
+title: Establish a TypeScript performance baseline
 weight: 5
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall
 ---
 
-## Baseline Setup for TypeScript
+## Set up your TypeScript baseline
 This section walks you through the baseline setup and validation of TypeScript on a Google Cloud C4A (Axion Arm64) virtual machine running SUSE Linux.
 The goal is to confirm that your TypeScript environment is functioning correctly, from initializing a project to compiling and executing a simple TypeScript file, ensuring a solid foundation before performance or benchmarking steps.
 
-### Set Up a TypeScript Project
+## Set Up a TypeScript Project
 Before running any tests, you’ll create a dedicated project directory and initialize a minimal TypeScript environment.
 
-1. Create project folder
+### Create project folder
 
 Start by creating a new folder to hold your TypeScript project files:
 
@@ -23,15 +23,15 @@ cd ~/typescript-benchmark
 ```
 This creates a workspace named `typescript-benchmark` in your home directory, ensuring all TypeScript configuration and source files are organized separately from system files and global modules.
 
-2. Initialize npm project
+### Initialize npm project
 
 Next, initialize a new Node.js project. This creates a `package.json` file that defines your project metadata, dependencies, and scripts.
 
 ```console
 npm init -y
 ```
 
-3. Install Node.js type definitions
+### Install Node.js type definitions
 
 To enable TypeScript to properly recognize Node.js built-in APIs (like fs, path, and process), install the Node.js type definitions package:
 
@@ -55,10 +55,10 @@ You should see output similar to:
 }
 ```
 
-### Baseline Testing
+## Perform baseline testing
 With the TypeScript environment configured, you’ll now perform a baseline functionality test to confirm that TypeScript compilation and execution work correctly on your Google Cloud SUSE Arm64 VM.
 
-1. Create a Simple TypeScript File
+### Create a Simple TypeScript File
 
 Create a file named `hello.ts` with the following content:
 
@@ -71,7 +71,7 @@ console.log(greet("GCP SUSE ARM64"));
 ```
 This simple function demonstrates TypeScript syntax, type annotations, and basic console output.
 
-2. Compile TypeScript
+### Compile TypeScript
 
 Use the TypeScript compiler (tsc) to transpile the .ts file into JavaScript:
 
@@ -80,7 +80,7 @@ tsc hello.ts
 ```
 This generates a new file named `hello.js` in the same directory.
 
-3. Run compiled JavaScript
+### Run compiled JavaScript
 
 Now, execute the compiled JavaScript using Node.js. This step verifies that:
 

content/learning-paths/servers-and-cloud-computing/typescript-on-gcp/benchmarking.md

@@ -1,18 +1,18 @@
 ---
-title: TypeScript Benchmarking
+title: Benchmark TypeScript performance
 weight: 6
 
 ### FIXED, DO NOT MODIFY
 layout: learningpathall
 ---
 
 
-## JMH-style Custom Benchmarking
+## Create a custom JMH-style benchmark for TypeScript on Arm
 
 This section demonstrates how to benchmark TypeScript functions using a JMH-style (Java Microbenchmark Harness) methodology implemented with Node.js's built-in `perf_hooks` module.
 Unlike basic `console.time()` measurements, this approach executes multiple iterations, computes the average runtime, and produces stable and repeatable performance data, useful for evaluating workloads on your Google Cloud C4A (Axion Arm64) VM running SUSE Linux.
 
-### Create the Benchmark Script
+## Implement benchmarking with Node.js perf_hooks on Arm
 Create a file named `benchmark_jmh.ts` inside your project directory with the content below:
 
 ```typescript
@@ -88,15 +88,15 @@ Iteration 10: 0.673 ms
 Average execution time over 10 iterations: 0.888 ms
 ```
 
-### Benchmark Metrics Explained
+## Run and analyze TypeScript benchmark results on Google Axion C4A
 
   * Iteration times → Each iteration represents the time taken for one complete execution of the benchmarked function.
   * Average execution time → Calculated as the total of all iteration times divided by the number of iterations. This gives a stable measure of real-world performance.
   * Why multiple iterations?
     A single run can be affected by transient factors such as CPU scheduling, garbage collection, or memory caching.
     Running multiple iterations and averaging the results smooths out variability, producing more repeatable and statistically meaningful data, similar to Java’s JMH benchmarking methodology.
 
-### Interpretation
+### Interpret your TypeScript performance data on Arm
 
 The average execution time reflects how efficiently the function executes under steady-state conditions.
 The first iteration often shows higher latency because Node.js performing initial JIT (Just-In-Time) compilation and optimization, a common warm-up behavior in JavaScript/TypeScript benchmarks.

content/learning-paths/servers-and-cloud-computing/typescript-on-gcp/installation.md

@@ -30,7 +30,7 @@ sudo zypper install -y nodejs npm
 ```
 This command installs the Node.js runtime and npm package manager on your Google Cloud SUSE Arm64 VM.
 
-### Install TypeScript globally
+## Install TypeScript globally
 TypeScript (tsc) is the compiler that converts .ts files into JavaScript.
 `ts-node` lets you run TypeScript files directly without pre-compiling them. It is useful for testing, scripting, and lightweight development workflows.
 
@@ -43,7 +43,7 @@ The `-g` flag installs packages globally, making tsc and ts-node available syste
 
 This approach simplifies workflows for developers running multiple TypeScript projects on the same VM.
 
-### Verify installations
+## Verify installations
 Check that Node.js, npm, TypeScript, and ts-node are all installed correctly:
 
 ```console