Skip to content

IGB-DOC-001

Documentation Architecture


Document ID : IGB-DOC-001

Title : Documentation Architecture

Version : v1.1

Status : Active

Owner : IGB Engineering

Last Update : 2026-08


Revision History

Version Date Description
v1.0 2026-08 Initial Release
v1.1 2026-08 Added Governance Policy, Directory README Standard, Documentation Lifecycle and Archive Policy

1. Purpose

This document defines the official documentation architecture for the IGB Engineering Platform.

Its purpose is to establish a unified documentation framework for engineering development, product lifecycle management, software, hardware, manufacturing, validation, security, and intellectual property.

This document serves as the highest-level documentation standard.


2. Scope

This specification applies to every repository belonging to the IGB Engineering Platform.

Including but not limited to

  • Hardware
  • Mechanical Design
  • PCB Design
  • Firmware
  • Software
  • AI Models
  • Manufacturing
  • Validation
  • Documentation

3. Documentation Principles

Documentation shall follow the following principles.

  • Single Source of Truth
  • Engineering First
  • Version Controlled
  • Git Managed
  • Human Readable
  • Machine Searchable
  • Long-term Maintainable

4. Documentation Directory Structure

The official documentation hierarchy shall be:

docs/

architecture/
engineering/
requirements/
communication/
security/
validation/
manufacturing/
software/
bom/
releases/
intellectual-property/
products/
specifications/
patents/
standards/
templates/
archive/

Each first-level directory shall contain a README.md.


5. Directory Definitions

architecture

System architecture

Architecture Constitution

Architecture Decision Records

Interface architecture


engineering

Engineering Design

Engineering Design Freeze

Engineering Change Notice

Engineering Reports


requirements

System Requirements

Product Requirements

Customer Requirements


communication

Communication Protocol

Networking

Mesh

Satellite

Radio


security

Security Design

Threat Model

Cryptography

Authentication

Secure Boot

TPM

HSM


validation

EVT

DVT

PVT

Reliability

Verification

Certification


manufacturing

Manufacturing

Assembly

Production

DFM

DFA

SOP


software

Software

Firmware

Operating System

Bootloader

Drivers

Application


bom

Bill of Materials

AVL

Approved Components

Lifecycle


releases

Release Notes

Software Releases

Hardware Releases

Engineering Releases


intellectual-property

Patents

Trademark

Copyright

Trade Secret

Licensing


products

Product Family

Product Definition

SKU

Roadmap


specifications

Electrical

Mechanical

Thermal

Environmental

Performance


patents

Patent Blueprints

Patent Drafts

Patent Research


standards

Corporate Documentation Standards

Naming Standards

Drawing Standards

Version Standards

Git Standards


templates

Engineering Templates

Document Templates

Drawing Templates

Meeting Templates


archive

Historical Documents

Deprecated Documents

Frozen Versions


6. Document Prefix Standard

Prefix Description
IGB-DOC Documentation
IGB-ARCH Architecture Constitution
IGB-ADR Architecture Decision Record
IGB-ECN Engineering Change Notice
IGB-ICD Interface Control Document
IGB-EDF Engineering Design Freeze
IGB-REQ Requirement
IGB-SEC Security
IGB-COM Communication
IGB-VAL Validation
IGB-MFG Manufacturing
IGB-SW Software
IGB-BOM Bill of Materials
IGB-IP Intellectual Property
IGB-REL Release

7. Directory README Standard

Every first-level directory shall include a README.md containing

  • Purpose
  • Scope
  • Document Prefix
  • Typical Contents
  • Related Documents
  • Owner
  • Status

8. Version Management

Official documents shall not include version numbers in filenames.

Example

Correct

IGB-DOC-001_Documentation_Architecture.md

Incorrect

IGB-DOC-001_Documentation_Architecture_v1.1.md

Document versions shall be maintained inside the document.


9. Archive Policy

Historical versions shall be stored in

docs/archive/

Git remains the authoritative version history.

Archived files are read-only.


10. Documentation Lifecycle

Draft

Review

Approved

Active

Engineering Freeze

Released

Archived


11. Governance Policy

No first-level documentation directory may be added, removed, or renamed without updating this document.

Every new directory shall

  • include README.md
  • define document prefixes
  • comply with this documentation architecture
  • be reviewed through an Architecture Decision Record (IGB-ADR)

12. Compliance

All engineering documentation shall comply with this standard.

Projects not conforming to this specification shall be considered non-compliant.


Appendix A

Documentation Root

docs/
├── architecture/
├── engineering/
├── requirements/
├── communication/
├── security/
├── validation/
├── manufacturing/
├── software/
├── bom/
├── releases/
├── intellectual-property/
├── products/
├── specifications/
├── patents/
├── standards/
├── templates/
└── archive/

Appendix B

This document is the root specification of the IGB Engineering Documentation System.

All future documentation standards shall inherit from this document.