docs: fix versions, provider lists, and broken internal links (#439)

* docs: align documentation with latest code

* docs: fix broken internal links and complete provider lists

* docs(README): clarify Go and Ubuntu requirements on separate lines

Author: arodage

README.md

@@ -11,14 +11,16 @@ A command-line tool for building custom Linux images from pre-built packages. De
 |----|-------------|--------------|
 | Azure Linux | azl3 | x86_64 |
 | Edge Microvisor Toolkit | emt3 | x86_64 |
+| Red Hat Compatible Distro | rcd10 | x86_64 |
 | Wind River eLxr | elxr12 | x86_64 |
 | Ubuntu | ubuntu24 | x86_64 |
 
 ## Quick Start
 
 ### 1. Build the Tool
 
-Requires Go 1.22.12+ on Ubuntu 24.04 (recommended).
+Requires Go 1.24+.
+Recommended Ubuntu 24.04
 
 ```bash
 git clone https://github.com/open-edge-platform/os-image-composer.git

docs/architecture/architecture.md

@@ -21,7 +21,7 @@
 
 The OS Image Composer is a tool for creating customized OS images from pre-built packages. It takes an image template file (YAML) as input and produces bootable OS images in raw or ISO formats suitable for deployment on bare metal systems, virtual machines, and edge devices.
 
-The tool uses a layered configuration approach: OS-specific default templates provide base settings for supported distributions (Azure Linux, Edge Microvisor Toolkit, and Wind River eLxr), which are merged with user-provided image templates to generate the final image specification. This approach simplifies the process by handling OS-specific details automatically while allowing full customization when needed.
+The tool uses a layered configuration approach: OS-specific default templates provide base settings for supported distributions (Azure Linux, Edge Microvisor Toolkit, Wind River eLxr, Ubuntu, and Red Hat-compatible distributions), which are merged with user-provided image templates to generate the final image specification. This approach simplifies the process by handling OS-specific details automatically while allowing full customization when needed.
 
 Pre-built packages are fetched securely from distribution-specific remote repositories over HTTPS, with automatic dependency resolution and GPG signature verification. The tool maintains local caches for both packages and reusable chroot environments to optimize build performance across multiple image builds.
 
@@ -57,7 +57,7 @@ The **Provider** component takes data from **Config** as its input, then orchest
 
 ### Provider
 
-The Provider component is the orchestrator of the image build process. Each supported operating system (Azure Linux, EMT, eLxr) has its own provider implementation that understands the specific requirements and package management for that OS.
+The Provider component is the orchestrator of the image build process. Each supported operating system (Azure Linux, EMT, eLxr, Ubuntu, RCD) has its own provider implementation that understands the specific requirements and package management for that OS.
 
 **Provider Interface:**
 - `Init(dist, arch string)` - Initialize the provider with distribution and architecture
@@ -71,6 +71,8 @@ The provider encapsulates all OS-specific logic while maintaining a consistent i
 - **Azure Linux** (azl3) - RPM-based distribution
 - **Edge Microvisor Toolkit** (emt3) - Specialized edge OS
 - **eLxr** (elxr12) - Wind River embedded Linux
+- **Ubuntu** (ubuntu24) - Debian-based distribution
+- **RCD** (rcd10) - Red Hat-compatible distributions
 
 ### Chroot
 

docs/architecture/os-image-composer-build-process.md

@@ -53,7 +53,7 @@ sudo -E os-image-composer build my-image-template.yml
 
 1. **Load Configuration** - Load global configuration and command-line overrides
 2. **Load and Merge Templates** - Parse user image template and merge with OS-specific default template for the image type and architecture
-3. **Initialize Provider** - Select the appropriate provider (Azure Linux, EMT, eLxr) based on template target (OS, distribution, architecture)
+3. **Initialize Provider** - Select the appropriate provider (Azure Linux, EMT, eLxr, Ubuntu, RCD) based on template target (OS, distribution, architecture)
 4. **PreProcess** - Provider validates template and prepares the build environment
 5. **BuildImage** - Provider executes the complete image build pipeline
 6. **PostProcess** - Provider performs cleanup and generates SBOM
@@ -225,7 +225,7 @@ This reuse significantly improves build performance, especially when building mu
 - Generate verification metadata
 - Store signature information in image metadata
 
-Image signing is optional and is only performed if configured in the template. See [Understanding Templates](./os-image-composer-templates.md#security-configuration) for signing configuration examples.
+Image signing is optional and is only performed if configured in the template. See [Understanding Templates](./os-image-composer-templates.md) for template configuration details.
 
 ### 5. Finalize Stage
 

docs/architecture/os-image-composer-cli-specification.md

@@ -39,9 +39,7 @@
 
 `os-image-composer` is a command-line tool for generating custom images for
 different operating systems, including
-[Azure Linux](https://github.com/microsoft/azurelinux),
-[Wind River eLxr](https://www.windriver.com/blog/Introducing-eLxr), and
-[Edge Microvisor Toolkit](https://github.com/open-edge-platform/edge-microvisor-toolkit).
+Azure Linux, Wind River eLxr, RCD, and Edge Microvisor Toolkit.
 The tool provides a flexible approach to creating and configuring
 production-ready OS images with precise customization.
 
@@ -206,7 +204,7 @@ os-image-composer --log-level debug validate my-image-template.yml
 
 See also:
 
-- [Validate Stage](./os-image-composer-build-process.md#1-validate-stage)
+- [Template Loading and Validation](./os-image-composer-build-process.md#1-template-loading-and-validation)
   for details on the validation process
 
 ### Inspect Command

docs/architecture/os-image-composer-templates.md

@@ -102,10 +102,10 @@ To learn about patterns that work well as templates, see
 Templates support simple variable substitution using the `${variable_name}`
 syntax. When building an image from a template, you can provide values for
 these variables. See the
-[Build Specification File](./os-image-composer-cli-specification.md#build-specification-file)
+[Image Template File](./os-image-composer-cli-specification.md#image-template-file)
 in the
 [command-line reference](./os-image-composer-cli-specification.md)
-for the complete structure of build specifications.
+for the complete template structure.
 
 ## Using Templates to Build Images
 
@@ -137,9 +137,9 @@ Templates in the OS Image Composer tool are stored in two main locations:
 To find out how variables affect each build stage, see
 [Build Stages in Detail](./os-image-composer-build-process.md#build-stages-in-detail).
 
-For details on customizations that you can apply, see the
-[Configuration Stage](./os-image-composer-build-process.md#4-configuration-stage)
-of the build process.
+For details on customizations that you can apply, see
+[Build Stages in Detail](./os-image-composer-build-process.md#build-stages-in-detail)
+in the build process documentation.
 
 ## Best Practices
 

docs/index.md

@@ -3,11 +3,9 @@
 OS Image Composer is a command-line tool that uses a simple toolchain to build
 mutable or immutable Linux distributions from the pre-built packages from
 different OS distribution repositories.
-Developed in the Go programming language, or Golang, the tool initially builds
+Developed in the Go programming language, or Golang, the tool builds
 custom images for
-[Edge Microvisor Toolkit](https://github.com/open-edge-platform/edge-microvisor-toolkit),
-[Azure Linux](https://github.com/microsoft/azurelinux) and
-[Wind River eLxr](https://www.windriver.com/blog/Introducing-eLxr).
+Edge Microvisor Toolkit, Azure Linux, Wind River eLxr, Ubuntu, and Red Hat-compatible distributions (RCD).
 
 ## Get Started
 
@@ -23,7 +21,7 @@ support portability across operating systems.
   [latest tagged release](https://github.com/open-edge-platform/os-image-composer/releases)
   of the ZIP archive.
 
-- Install version 1.22.12 or later of the Go programming language before
+- Install version 1.24.0 or later of the Go programming language before
   building the tool; see the
   [Go installation instructions](https://go.dev/doc/manage-install)
   for your Linux distribution.

docs/tutorial/configure-additional-actions-for-build.md

@@ -80,7 +80,7 @@ systemConfig:
 
 ## Real-World Example
 
-From the [`ubuntu24-mah.yml`](../image-templates/ubuntu24-mah.yml) template:
+From an example Ubuntu template with custom actions:
 
 ```yaml
 systemConfig:
@@ -229,6 +229,6 @@ systemConfig:
 
 ## Related Documentation
 
-- [Image Template Format](../architecture/image-template-format.md)
+- [Image Templates](../architecture/os-image-composer-templates.md)
 - [Understanding the OS Image Build Process](../architecture/os-image-composer-build-process.md)
 - [Command-Line Reference](../architecture/os-image-composer-cli-specification.md)

docs/tutorial/configure-multiple-package-repositories.md

@@ -310,6 +310,6 @@ packageRepositories:
 
 ## Related Documentation
 
-- [Image Template Format](../architecture/image-template-format.md)
+- [Image Templates](../architecture/os-image-composer-templates.md)
 - [Understanding the OS Image Build Process](../architecture/os-image-composer-build-process.md)
 - [Configuring Custom Commands During Image Build](configure-additional-actions-for-build.md)

docs/tutorial/installation.md

@@ -17,7 +17,7 @@ prerequisites.
 
 - **OS**: Ubuntu 24.04 (recommended; other standard Linux distributions may
   work but are not validated)
-- **Go**: Version 1.22.12 or later — see
+- **Go**: Version 1.24.0 or later — see
   [Go installation instructions](https://go.dev/doc/manage-install)
 
 ## Development Build (Go)