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.