Merge pull request #2726 from ArmDeveloperEcosystem/main

production update

Author: jasonrandrews

content/install-guides/codex-cli.md

@@ -1,6 +1,6 @@
 ---
 title: Codex CLI
-draft: true
+
 author: Joe Stech
 minutes_to_complete: 10
 official_docs: https://developers.openai.com/codex/cli/
@@ -16,9 +16,9 @@ tool_install: true
 weight: 1
 ---
 
-Codex CLI is a lightweight coding agent from OpenAI that runs locally in your terminal. It can help you with coding tasks, understand your codebase, run commands, and assist with development workflows.
+Codex CLI is a local, terminal-based coding agent from OpenAI that helps developers explore codebases, generate changes, and run commands using natural language. It’s useful for tasks such as understanding unfamiliar projects, refactoring code, and accelerating development workflows directly from the command line.
 
-It supports multiple operating systems, including Arm-based Linux distributions and macOS.
+Codex CLI supports multiple operating systems, including Arm-based Linux distributions and macOS. By integrating AI assistance directly into command-line workflows, it reduces context switching during development.
 
 This guide explains how to install Codex CLI on macOS and Arm Linux.
 
@@ -28,11 +28,9 @@ You need an OpenAI account to use Codex CLI. You can either sign in with your [C
 
 Codex CLI requires Node.js 18 or later.
 
-This guide explains how to install Codex CLI on macOS and Arm Linux.
-
 ## How do I download and install Codex CLI?
 
-On most systems, you should install codex using `npm`. On macOS Homebrew can also be used.
+On most systems, install Codex CLI using npm. On macOS, there is also the option for you to use Homebrew.
 
 ### How do I use npm to install Codex CLI?
 
@@ -66,13 +64,15 @@ Install the required packages on Ubuntu/Debian systems:
 sudo apt update && sudo apt install -y curl
 ```
 
-If you are not using Ubuntu/Debian use your package manager to install curl.
+If you're not using Ubuntu/Debian, use your package manager to install curl.
 
 ### How do I install Node.js on Arm Linux?
 
+{{% notice Note %}}If you already have Node.js 18 or later installed, you can skip this section.{{% /notice %}}
+
 Codex CLI requires Node.js version 18 or higher. The easiest way to install Node.js on Arm Linux is using the NodeSource repository.
 
-Download and run the Node.js setup script (example shown for Node.js 22.x):
+Download and run the Node.js setup script. For example, for Node.js 22.x:
 
 ```bash
 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
@@ -120,7 +120,7 @@ sudo npm install -g @openai/codex
 
 This downloads and installs the latest version of Codex CLI.
 
-### How do I confirm Codex CLI is working?
+## How do I confirm Codex CLI is working?
 
 You now have the latest version of Codex CLI installed.
 
@@ -133,10 +133,10 @@ codex --version
 The output shows the version:
 
 ```output
-@openai/codex, 0.77.0
+@openai/codex, 0.79.0
 ```
 
-### How do I authenticate with OpenAI?
+## How do I authenticate with OpenAI?
 
 There are two ways to authenticate with Codex CLI.
 
@@ -229,10 +229,10 @@ At the Codex prompt, run the `/mcp` command to view active MCP servers and their
 /mcp
 ```
 
-You should see the Arm MCP server listed. If the arm-mcp server says it's still loading, wait a moment and check again.
+The Arm MCP server is listed in the output. If the arm-mcp server indicates it's still loading, wait a moment and check again.
 
 You can also verify the tools are available by asking Codex to list the available Arm MCP tools.
 
-If you are facing issues or have questions, reach out to mcpserver@arm.com.
+If you're facing issues or have questions, reach out to mcpserver@arm.com.
 
-You're ready to use Codex CLI.
+You're now ready to use Codex CLI with Arm-specific development assistance.

content/install-guides/linux-migration-tools.md

@@ -1,8 +1,6 @@
 ---
 title: Arm Linux Migration Tools
 
-draft: true 
-
 additional_search_terms:
 - migration
 - porting
@@ -42,11 +40,11 @@ multitool_install_part: false
 weight: 1
 ---
 
-[Arm Linux Migration Tools](https://github.com/arm/arm-linux-migration-tools) provides a comprehensive collection of thirteen essential utilities to help you migrate applications from x86 to Arm Linux systems. Instead of installing and managing each tool individually, you get everything you need in a single, streamlined installation.
+[Arm Linux Migration Tools](https://github.com/arm/arm-linux-migration-tools) provides a comprehensive collection of 13 essential utilities to help you migrate applications from x86 to Arm Linux systems. Instead of installing and managing each tool individually, get everything you need in a single, streamlined installation.
 
-This package includes code analysis, performance, and migration tools such as Sysreport, Skopeo, LLVM Machine Code Analyzer, Telemetry Solution, KubeArchInspect, Migrate Ease, Aperf, BOLT, PAPI, Perf, Process Watch, Check Image, and Porting Advisor for Graviton. These tools help you assess application compatibility, analyze performance characteristics, optimize code layout, and identify potential issues before and after migration.
+This package includes code analysis, performance, and migration tools such as Sysreport, Skopeo, LLVM Machine Code Analyzer, Telemetry Solution, KubeArchInspect, Migrate Ease, Aperf, BOLT, PAPI, Perf, Process Watch, Check Image, and Porting Advisor for Graviton. These tools assess application compatibility, analyze performance characteristics, optimize code layout, and identify potential issues before and after migration.
 
-Whether you're migrating containerized applications, analyzing system performance, or optimizing binaries for Arm processors, this package simplifies your migration workflow by providing all the necessary tools through a unified installation process, saving you time on setup and configuration. 
+Whether you're migrating containerized applications, analyzing system performance, or optimizing binaries for Arm processors, this package simplifies your migration workflow by providing all necessary tools through a unified installation process. 
 
 ## What are the tools included in Arm Linux Migration Tools? 
 
@@ -154,7 +152,7 @@ cd arm-linux-migration-tools
 sudo ./scripts/install.sh
 ```
 
-After successful installation, you can remove the downloaded files:
+After successful installation, remove the downloaded files:
 
 ```bash
 cd ..
@@ -202,7 +200,7 @@ The install script:
 - Sets up the Python virtual environment with the built dependencies
 - Configures permissions for all installed components
 
-After successful installation, you can clean up the build directory:
+After successful installation, clean up the build directory:
 
 ```bash
 cd ..
@@ -213,21 +211,29 @@ rm -rf arm-linux-migration-tools
 
 After successful installation, the Arm Linux Migration Tools are organized in a structured directory layout that separates the core tools, dependencies, and user-accessible commands. Understanding this structure helps you troubleshoot issues and manage the installation effectively.
 
-All tools and their dependencies are installed in the `/opt/arm-migration-tools/` directory. Review the details of the software installed there. 
+All tools and their dependencies are installed in the `/opt/arm-migration-tools/` directory:
+
+```bash
+ls /opt/arm-migration-tools/
+```
 
-For easy access from anywhere in your system, wrapper scripts are also installed in `/usr/local/bin/`, making it easier to invoke each tool. View the available executables there.
+For easy access from anywhere in your system, wrapper scripts are installed in `/usr/local/bin/`:
+
+```bash
+ls /usr/local/bin/ | grep -E "(sysreport|skopeo|llvm-mca|topdown-tool|kubearchinspect|migrate-ease|aperf|llvm-bolt|papi|perf|processwatch|check-image|porting-advisor)"
+```
 
 ### Python virtual environment
 
 A Python virtual environment is located at `/opt/arm-migration-tools/venv/` and contains all Python packages required by the migration tools.
 
-The wrapper scripts in `/usr/local/bin` use this environment automatically, but you can activate it with:
+The wrapper scripts in `/usr/local/bin` use this environment automatically. To activate it manually:
 
 ```bash
 source /opt/arm-migration-tools/venv/bin/activate
 ```
 
-You can view the installed Python packages in the virtual environment:
+View the installed Python packages in the virtual environment:
 
 ```bash
 /opt/arm-migration-tools/venv/bin/pip list
@@ -295,15 +301,15 @@ Execute the included test script to verify all 13 tools are properly installed a
 The script performs a basic invocation of each tool to confirm it runs.
 
 {{% notice Note %}}
-If you get an error on Topdown Tool you need to run the commands below. 
+If you get an error when running Topdown Tool, run these commands:
 ```console
 sudo sh -c "echo -1 > /proc/sys/kernel/perf_event_paranoid"
 sudo sh -c "echo 0 > /proc/sys/kernel/kptr_restrict"
 ```
-More information about the options is in the [Linux Perf install guide](/install-guides/perf/).
+For more information about these options, see the [Linux Perf install guide](/install-guides/perf/).
 {{% /notice %}}
 
-### Next steps
+## Next steps
 
 Now that you have successfully installed and verified the Arm Linux Migration Tools, you're ready to begin.
 

content/learning-paths/servers-and-cloud-computing/arm-mcp-server/1-overview.md

@@ -92,6 +92,6 @@ The required configuration steps vary by AI coding assistant. Refer to the insta
 - [GitHub Copilot](/install-guides/github-copilot/)
 - [Gemini CLI](/install-guides/gemini/)
 - [Kiro CLI](/install-guides/kiro-cli/)
-- Codex CLI
+- [Codex CLI](/install-guides/codex-cli/)
 
 In the next section, you'll use direct AI chat with the Arm MCP Server to check Docker base images for Arm compatibility.