Skip to content

Framework Alignment

ADS maps to multiple established frameworks. This page documents both the alignment (what ADS shares with each framework) and the differences (what ADS adds or does differently).

Each section page in the standard shows badges indicating which frameworks influenced that section:

BadgeMeaning
ISO 42010Aligns with the ISO/IEC/IEEE 42010 conceptual model
4+1 ViewMaps to a view in Kruchten’s 4+1 Architectural View Model
TOGAFAligns with a TOGAF architecture domain
AWS WAFDerived from the AWS Well-Architected Framework
Azure WAFDerived from the Azure Well-Architected Framework

The badges are informational only — they show provenance, not requirements. You do not need to comply with these external frameworks to conform to ADS.

ADS follows the ISO 42010 conceptual model for architecture descriptions:

ISO 42010 ConceptADS Mapping
System of InterestThe solution being documented
StakeholdersStakeholders & Concerns
ConcernsConcerns Matrix
Architecture ViewpointDefined viewpoints
Architecture ViewThe content within each view
Model KindDiagrams, tables, and descriptions within views
CorrespondencesCross-references between views and quality attribute refs
Architecture DescriptionThe complete Solution Architecture Document

ISO 42010 is a meta-standard — it defines concepts but deliberately leaves the concrete structure to implementers. ADS provides that concrete structure:

AspectISO 42010ADS
Prescribes sections?No — defines concepts onlyYes — exact sections, tables, and fields
Quality assessment?NoYes — quality attributes from cloud WAFs
Documentation depths?NoYes — Minimum, Recommended, Comprehensive with RFC 2119
Security viewpoint?Not prescribedYes — dedicated Security View
Lifecycle coverage?Focuses on the AD itselfYes — CI/CD, operations, migration, exit planning
Risk and governance?NoYes — constraints, risks, assumptions, ADRs, compliance
Templates?NoYes — Markdown, YAML, JSON
Machine-readable schema?NoYes — JSON Schema with validation

ADS uses the 4+1 model as the foundation for its architectural views:

4+1 Original ViewADS ViewKey Content
Logical ViewLogical ViewComponent architecture, service mapping
Process ViewIntegration & Data Flow View (adapted)Data flows, integrations, interfaces
Development ViewLifecycle ManagementCI/CD, SDLC, tooling
Physical ViewPhysical ViewDeployment, infrastructure, networking
+1 ScenariosScenariosUse cases, ADRs
Aspect4+1ADS
Data architecture?Cross-cutting across viewsDedicated Data View
Security architecture?Cross-cutting across viewsDedicated Security View
Process View scopeConcurrency and threadingAdapted to integration and data flows
Quality assessment?NoYes — cross-cutting quality attributes
Documentation depths?NoYes — three tiers

Cloud Well-Architected Frameworks (AWS, Azure, GCP, Oracle, IBM)

Section titled “Cloud Well-Architected Frameworks (AWS, Azure, GCP, Oracle, IBM)”

ADS derives its quality attributes from the cloud Well-Architected Frameworks:

Note: The cloud providers use American English spelling (e.g., “Optimization”). ADS uses British English (e.g., “Optimisation”). The table below preserves each provider’s original spelling.

Quality AttributeAWSAzureGCPOracleIBM
Operational ExcellenceOperational ExcellenceOperational ExcellenceOperational ExcellenceOperational EfficiencyOperational Excellence
SecuritySecurity (ADS maps this to a dedicated Security View)Security (ADS maps this to a dedicated Security View)Security, Privacy & Compliance (ADS maps this to a dedicated Security View)Security & Compliance (ADS maps this to a dedicated Security View)Security (ADS maps this to a dedicated Security View)
ReliabilityReliabilityReliabilityReliabilityReliability & ResilienceReliability
PerformancePerformance EfficiencyPerformance EfficiencyPerformance Optimization(combined with Cost)Performance
CostCost OptimizationCost OptimizationCost OptimizationPerformance & Cost OptimizationCost Optimization
SustainabilitySustainability(not separate)Sustainability(not separate)(not separate)
(provider-specific)Distributed CloudHybrid & Portable
AspectCloud WAFsADS
FocusQuality assessment onlyFull SAD structure (views + quality + lifecycle + governance)
Architectural views?NoYes — six views
SecurityA quality pillarElevated to a dedicated Architectural View
Document structure?No — assessment questions onlyYes — prescriptive sections and tables
Templates?NoYes — Markdown, YAML, JSON
Provider-neutral?Each is provider-specificYes — maps across all providers

ADS maps its sections to TOGAF’s four architecture domains:

TOGAF DomainADS Section
Business ArchitectureExecutive Summary, Stakeholders
Data ArchitectureData View
Application ArchitectureLogical View, Integration & Data Flow View
Technology ArchitecturePhysical View
AspectTOGAFADS
ScopeFull enterprise architecture framework (ADM lifecycle, capability planning, governance)SAD template only — focused on documenting a single solution
Prescribes SAD sections?No — TOGAF describes what an architecture should address but not the document structureYes — exact sections, tables, and fields
Quality attributes?NoYes — cross-cutting quality attributes from cloud WAFs
Security view?Security is a cross-cutting concernYes — dedicated Security View
Templates?No (paid ArchiMate tooling available separately)Yes — free Markdown, YAML, JSON templates
Compliance scoring?NoYes — 0–5 scale per section
CostPaid (TOGAF certification and library access)Free and open-source (CC BY 4.0)

Both ADS and arc42 aim to provide a practical template for documenting software/solution architecture. They share:

  • A view-based approach to describing architecture
  • Explicit sections for quality requirements
  • A glossary and cross-references section
Aspectarc42ADS
Security view?No — security is in “cross-cutting concepts”Yes — dedicated Security View
Data view?NoYes — dedicated Data View
Quality attributes?Quality scenarios (unstructured)Structured quality attributes aligned to cloud WAFs
Documentation depths?NoYes — three tiers with RFC 2119
Machine-readable schema?No — prose onlyYes — JSON Schema with validation
Compliance scoring?NoYes — 0–5 scale per section
Governance section?Partial (risks and technical debt)Full — constraints, assumptions, risks, dependencies, issues, ADRs, compliance traceability
Lifecycle management?PartialFull — CI/CD, migration, resourcing, decommissioning, exit planning
ADS SectionISO 420104+1Cloud WAFsTOGAF
Document ControlAD metadata
Executive SummaryBusiness
StakeholdersStakeholders, ConcernsBusiness
Logical ViewViewpoint, ViewLogicalApplication
Integration & Data FlowViewpoint, ViewProcess (adapted)Application
Physical ViewViewpoint, ViewPhysicalTechnology
Data ViewViewpoint, View(extended)Data
Security ViewViewpoint, View(extended)Security
ScenariosCorrespondences+1 Scenarios
Operational ExcellenceOps Excellence
Reliability & ResilienceReliability
Performance EfficiencyPerformance
Cost OptimisationCost Optimization
SustainabilitySustainability (AWS, GCP)
Lifecycle ManagementDevelopmentOps Excellence
Decision Making & GovernanceCorrespondences