Architecture Documentation (Content Foundry)
Content Foundry provides a wide range of specialised content blocks covering layout, data, decisions, requirements, diagrams and more for architecture documentation, technical specifications, and knowledge bases. Capture decisions, risks, requirements, operations, and planning in structured, searchable formats with page versioning and comprehensive theme colour variables.
Block Categories at a Glance
Every block type serves a specific documentation purpose. The categories cover the full lifecycle of architecture work.
| Category | Blocks | Purpose |
|---|---|---|
| Decision | 4 | Assumptions, constraints, principles, NFRs |
| Risk | 4 | Individual risks, risk registers, failure scenarios, what-if analysis |
| Technical | 6 | Component responsibilities, data lifecycle, trade-off matrices, operational notes |
| Requirements | 19 | Functional requirements, acceptance criteria, user stories, use cases, business rules |
| Testing | 6 | Test plans, test cases, test matrices, coverage tracking |
| Operations | 8 | Runbooks, deployment checklists, monitoring definitions, incident templates |
| Planning | 10 | Roadmaps, milestones, dependency tracking, capacity planning |
| Reference | 16 | Glossaries, lookup tables, configuration references, environment matrices |
| Content | 6+ | Rich text, code blocks, images, videos, tables of contents, links |
| Diagram | 4 | Standard diagrams, presentation diagrams, graph diagrams, graph links |
| Integration | 2+ | Embedded REST API endpoints, embedded schema definitions |
| Marketing | 4 | Hero banners, animated hero backgrounds, feature grids, call-to-action buttons |
Decision Documentation
Architecture is about decisions. Content Foundry gives you structured blocks to capture the thinking behind your designs.
Risk Documentation
Architecture decisions involve trade-offs and risks. Content Foundry helps you document them systematically.
Requirements, Testing, and Planning
Content Foundry extends beyond architecture decisions into the full documentation lifecycle.
Technical Documentation
Connect your documentation to live definitions and capture operational knowledge.
Adding Blocks
Content Foundry provides three ways to add blocks to a page, from browsing to keyboard-driven workflows.
Page Versioning
Content Foundry tracks page history with version stamping.
Site Customisation and Forms
Content Foundry includes site-level customisation and interactive form support.
| Feature | Details |
|---|---|
| Theme Colour Variables | CSS colour variables for complete site customisation, covering backgrounds, text, borders, accents, and component-specific colours |
| Forms | 9 control types for interactive content: text input, textarea, select, checkbox, radio, date picker, number, toggle, and file upload |
| Marketing Home Sections | 6 section types for landing pages: hero, feature-grid, CTA, graph-links, diagram, and graph-diagram |
Content and Diagrams
Content Foundry includes standard documentation blocks plus diagram integration.
Documentation That Stays Current
When documentation lives alongside code in the same repository, the same pull request can update both an API implementation and the architecture pages that describe it. Reviewers see the full picture. Merge conflicts surface when two people change the same documentation, just as they would for code. There is no separate documentation system to remember to update later.
This documentation site was built entirely using Content Foundry. Every page you read here uses the same blocks and publishing workflow available to you.
Complete reference for all content block types in Content Foundry. Blocks organised into categories covering documentation, diagrams, charts, decisions, risk, APIs, testing, operations, and marketing.
Architecture documentation is more than just diagrams. Learn how to capture decisions, risks, requirements, and technical specifications in structured, searchable formats.
Master the specialised content blocks for architecture documentation including decisions, risks, technical specifications, and diagrams. Add blocks via the block panel, fuzzy search, or the command palette.