Archyno
Modelling practice

Modelling practice: scope, naming, upkeep

How much to model, what to call things, and how to keep a model alive after the project that created it - the decisions that decide whether anybody reads it in a year.

3 articles17 min read

Start here

How much of a system to model

A test for deciding how much of a system to model: name the decision each view informs, and delete the views that inform none. Plus the three failure modes of an unscoped model.

6 min read

Read in order

The part no specification covers

  1. 02Naming conventionsNaming conventions for UML and ArchiMate models argued from searchability: nouns for classifiers, verbs for behaviour, the domain's own words, and what to do about acronyms.Modelling practice5 min read
  2. 03Keeping a model currentWhy architecture models go stale and what actually prevents it: attaching the model to a step that already happens, shrinking it to what the team will maintain, and deleting the rest.Modelling practice6 min read

The other series

All articles