FDO Architecture Specification

This repository contains the FDO Architecture Specification, developed and maintained by the TSIG Working Group of the FDO Forum.

The specification describes the overall architectural model of FDO, its core components, their responsibilities, and the interactions between them. It is intended to provide a common technical reference for implementers, reviewers, and contributors.

The authoritative rendered version of the specification is published via GitHub Pages.

Scope and Purpose

The purpose of this specification is to:

• Define the high‑level architecture of the FDO system
• Describe the main architectural components and their roles
• Provide a stable architectural reference for implementations
• Support consistent interpretation across different implementations

This document focuses on architecture and design principles. Protocol details, APIs, and implementation‑specific aspects are covered in separate specifications.

Document Organization

The specification is organized into logical sections, each maintained as an individual source file and assembled for presentation on GitHub Pages.

This modular organization is intended to improve maintainability and reviewability while preserving a single, coherent rendered document.

Status of This Document

This specification is developed under the governance of the FDO Forum.

• The document may evolve over time
• Not all sections may be complete at all times
• Changes are discussed and reviewed through the repository’s issue and pull request process

Unless explicitly stated otherwise, the content in this repository should be considered work in progress.

Repository Structure

The repository is organized as follows:

docs/        Rendered specification (GitHub Pages)
sections/    Individual specification sections (HTML source)
assets/      Stylesheets and scripts used for rendering
images/      Images included in the sections

The index.html file serves as the entry point for the published specification.

Contributing

Contributions are welcome and encouraged.

Typical contributions include:

• Clarifications and editorial improvements
• Architectural refinements
• Consistency fixes across sections
• Issue reports and discussion proposals

Please use GitHub Issues for discussions and Pull Requests for proposed changes. Contributions should follow the architectural scope and terminology defined by the FDO Forum.

Governance

This specification is organized and maintained by the FDO Forum.
All technical decisions, changes, and approvals are made according to the forum’s governance and review processes.

License

The licensing terms for this specification are defined in the repository’s LICENSE file.
Please review it before reusing or redistributing the content.