What is this feature about?
Model elements should be able to cite external literature precisely and machine-readably, not just in prose. When a term, aggregate, command, or read model rests on a specific source, the model should carry an exact reference to it. The difference matters for humans and AI alike: "Göhner's frame of reference" versus "Göhner (1987, Bewegungsanalyse im Sport, p. 7)" leads to very different results.
The proposed shape is BibTeX-oriented, similar to pandoc citations:
references:
- file: path/to/literature.bib
key: "@goehner87"
pages: 7
The reference should be attachable wherever it is useful – on ubiquitous-language terms, aggregates, read models, commands, and so on. Today ESDM has no such concept.
What needs to be done to implement this feature?
What else should we know?
Open design questions (user-facing, need sign-off):
- The exact field shape and where it is allowed.
- Whether the
.bib file is resolved and validated by the tooling or treated as an opaque pointer.
Further notes:
What is this feature about?
Model elements should be able to cite external literature precisely and machine-readably, not just in prose. When a term, aggregate, command, or read model rests on a specific source, the model should carry an exact reference to it. The difference matters for humans and AI alike: "Göhner's frame of reference" versus "Göhner (1987, Bewegungsanalyse im Sport, p. 7)" leads to very different results.
The proposed shape is BibTeX-oriented, similar to pandoc citations:
The reference should be attachable wherever it is useful – on ubiquitous-language terms, aggregates, read models, commands, and so on. Today ESDM has no such concept.
What needs to be done to implement this feature?
referencesbuilding block (a.bibfile plus a citation key and optional pages), following pandoc's citation model as a guide..bibfile) and whether that is a linter concern.What else should we know?
Open design questions (user-facing, need sign-off):
.bibfile is resolved and validated by the tooling or treated as an opaque pointer.Further notes: