Summary
Request to add comprehensive best-practices documentation for enterprise architecture frameworks, starting with TOGAF (The Open Group Architecture Framework) and related methodologies.
Proposed Documentation
New Category: enterprise-architecture/
Create a new docs/best-practices/enterprise-architecture/ directory with documentation for:
-
TOGAF - The Open Group Architecture Framework
- Architecture Development Method (ADM)
- Architecture Content Framework
- Enterprise Continuum & Tools
- Reference Models (TRM, III-RM)
- Architecture Governance
-
ArchiMate - The Open Group modeling language for enterprise architecture
- Core Framework elements
- Modeling best practices
- Integration with TOGAF
-
Zachman Framework - Enterprise architecture ontology
- Framework structure (What, How, Where, Who, When, Why)
- Implementation guidance
Dictionary Updates (docs/dictionary.md)
Add entries for:
- TOGAF - Enterprise architecture framework
- ArchiMate - Enterprise architecture modeling language
- Zachman Framework - EA classification schema
- ADM (Architecture Development Method) - TOGAF's iterative method
- Enterprise Architecture - Foundational term
- Architecture Repository - Storage for architecture artifacts
- Building Blocks - TOGAF reusable components (ABBs, SBBs)
CHANGELOG Updates
Add entry under [Unreleased] section:
- Enterprise Architecture documentation category
- TOGAF, ArchiMate, Zachman Framework best practices
- Related dictionary terms
Rationale
Enterprise Architecture frameworks are essential for:
- Aligning IT strategy with business goals
- Managing complexity in large organizations
- Standardizing architecture practices across teams
- Digital transformation initiatives
This aligns with the existing enterprise/ and system-architecture/ documentation patterns while creating a dedicated space for EA frameworks.
Related Categories
docs/best-practices/enterprise/ - Enterprise systems (SAP, Salesforce, MuleSoft)
docs/best-practices/system-architecture/ - System design patterns
Acceptance Criteria
Summary
Request to add comprehensive best-practices documentation for enterprise architecture frameworks, starting with TOGAF (The Open Group Architecture Framework) and related methodologies.
Proposed Documentation
New Category:
enterprise-architecture/Create a new
docs/best-practices/enterprise-architecture/directory with documentation for:TOGAF - The Open Group Architecture Framework
ArchiMate - The Open Group modeling language for enterprise architecture
Zachman Framework - Enterprise architecture ontology
Dictionary Updates (
docs/dictionary.md)Add entries for:
CHANGELOG Updates
Add entry under
[Unreleased]section:Rationale
Enterprise Architecture frameworks are essential for:
This aligns with the existing
enterprise/andsystem-architecture/documentation patterns while creating a dedicated space for EA frameworks.Related Categories
docs/best-practices/enterprise/- Enterprise systems (SAP, Salesforce, MuleSoft)docs/best-practices/system-architecture/- System design patternsAcceptance Criteria
enterprise-architecture/directory with READMEdocs/dictionary.mdwith new termsCHANGELOG.mdwith changesREADME.mdto include new category