Linked.Archi — Semantic Assets Documentation¶
Linked.Archi is an ecosystem for building architectural knowledge graphs that unify disparate enterprise architecture sources using semantic web technologies. This documentation covers the ontologies, metamodels, and design patterns that form the semantic foundation.
Getting Started¶
| If you want to... | Read |
|---|---|
| Understand what Linked.Archi is | What is Linked.Archi? |
| Get started quickly | Quick Start Guide |
| Understand the philosophy | Architecture & Approach |
| Choose and combine modeling languages | Modeling Languages Guide |
| Understand the extensions | Extensions Guide |
| Understand the frameworks | Frameworks Guide |
| Design a metamodel | Relationship Modeling Guide |
| Explore the ontology catalog | Ontology Reference |
| Understand modeling choices | Design Decisions |
| Validate ontologies and models | Validation Guide |
| Author models as code | Semantic Architecture as Code |
| Evaluate DSL options | ArchiMate in Structurizr DSL and Beyond |
| See real-world scenarios | Use Cases |
| Build tooling | Toolbox Overview |
Key Concepts¶
| Concept | What it is |
|---|---|
arch:ModelConcept |
Base class for everything in a model: elements, relationships, views |
arch:Element |
Nodes in the architecture (subclassed per metamodel) |
arch:QualifiedRelationship |
First-class relationship resources (subclassed per metamodel) |
arch:View / arch:Viewpoint |
Stakeholder-specific representations |
arch:Metamodel |
Manifest aggregating all resources for a modeling language (see DD-17) |
arch:DeliverableTemplate |
Template defining document structure via viewpoint placeholders |
arch:PresentationFormat |
Output format for rendering deliverables (Markdown, HTML, PDF) |
arch:unqualifiedForm |
Schema-level mapping from qualified form to direct predicate |
Namespace Reference¶
| Prefix | Namespace |
|---|---|
arch: |
https://meta.linked.archi/core# |
amate: |
https://meta.linked.archi/archimate3/onto# |
ad: |
https://meta.linked.archi/arch-decision# |
ap: |
https://meta.linked.archi/arch-processes# |
refa: |
https://meta.linked.archi/ref-arch# |
togaf: |
https://meta.linked.archi/togaf/metamodel# |
timefw: |
https://meta.linked.archi/time-framework/onto# |
Building the Documentation¶
The documentation is built with MkDocs Material. To serve locally:
Then open http://127.0.0.1:8000/.
To build a static site:
The GitLab CI pipeline (.gitlab-ci.yml) builds and deploys to GitLab Pages automatically on changes to doc/.
Additional Resources¶
Architecture practice guidance — comparisons, positioning, and strategy for using the metamodels alongside other modeling approaches — is in doc/practice/. See the practice README for the full list.